github上如何为markdown文件生成目录

文章目录

    • 写在前面
    • 网页生成
    • 使用toc工具
    • 最简单的markdown插件

写在前面

熟悉markdown都知道可以使用[TOC]自动生成markdown文件的标题目录,比如在typora,vscode(需要插件)等本地编辑器中,或者在CSDN等网页编辑器中,但是github却不支持[TOC]标签,至于为什么不支持感兴趣的可以深入搜索,而相应的解决方法之一就是为md文件自动生成适用于github的目录。

网页生成

有没有这样自动生成目录的操作呢?答案是有的,其中之一就是在线的generator,比如GitHub Wiki TOC generator。但是经本人实测并不好用且麻烦。

使用toc工具

网页生成的方法并不好用,使用toc工具,比如gh-md-toc这个神器,如何安装可参考这篇博文快速生成Github README.md的目录。安装后在终端输入命令就可以在终端里生成目录,但是也比较麻烦,因为是在终端生成的,复制粘贴到md文件里比较麻烦,还要注意格式对齐的问题。

最简单的markdown插件

笔者目前了解到的最最最简单的莫过于VSCode中的Markdown All in One
插件了,安装后点开md文件,然后快捷键CTRL(CMD)+SHIFT+P,输入Markdown All in One: Create Table of Contents回车即可,如下:
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

原文地址:https://www.cnblogs.com/hzcya1995/p/13281668.html