Github上的Markdown文件是遵循Markdown语法的,但是Markdown本身并没有绝对标准,Github的渲染方式与一些常用Markdown渲染方式不相同,导致在使用时有些麻烦。事实上大部分和普通Markdown还是类似的,但是目录的语法差别蛮大,导致[TOC]不能生成目录。
现在我们使用gh-md-toc
为Github上的Markdown文件生成目录。gh-md-toc这个东西在Mac和Linux很友好,windows似乎不那么友好。不过这里也给了windows的解决方案。
这就是github-markdown-toc.go,如果你有GO语言(又是你)的编译环境,可以尝试自己编译,如果没有,可以直接下载编译好的二进制文件。
下载下来之后,发现没有后缀名无法识别,实际上这是个exe文件,所以只需要在后面加上.exe后缀就可以开始愉快使用了。
首先将README.md文档复制到gh-md-toc.exe的根目录下,接着按住shift键同时右击。
打开Powershell窗口后,直接键入gh-md-toc.exe Base.md
接下来只需将生成的目录粘贴到Markdown文件里面即可,如果看后面的字符不太习惯,可以解码成中文字符。
我的微信
扫一扫加我微信