由于码云和github的markdown解析器,都不支持 [toc],码云官方推荐的是使用<a>标签来生成目录,由于我的文档目录过多,这种方式显然很不现实。所以在网上找到了如下的方式,这里先贴一下原帖地址。
https://www.jianshu.com/p/302abe331dcb
windows的 gh-md-toc.exe地址: https://www.lanzous.com/i4szwrg
我这里放的是我自己在蓝奏云上面备份的文件,如果你需要下载最新的,请移步Github下载:
https://github.com/ekalinin/github-markdown-toc.go/releases
生成方式很简单,先贴一下我的md文件内容,由于原文件涉及隐私内容,所以这里使用例子演示一下
将文件放在 gh-md-toc.exe 的同级目录 ,打开cmd窗口,输入 gh-md-toc.exe README.md,回车,然后将生成的这一大段内容粘贴到你的md文件中,上传到码云或github即可显示目录