Github Markdown文件生成目录

Github上的Markdown文件是遵循Markdown语法的,但是Markdown本身并没有绝对标准,Github的渲染方式与一些常用Markdown渲染方式不相同,导致在使用时有些麻烦。事实上大部分和普通Markdown还是类似的,但是目录的语法差别蛮大,导致[TOC]不能生成目录。

现在我们使用gh-md-toc为Github上的Markdown文件生成目录。gh-md-toc这个东西在Mac和Linux很友好,windows似乎不那么友好。不过这里也给了windows的解决方案。

Github Markdown文件生成目录

这就是github-markdown-toc.go,如果你有GO语言(又是你)的编译环境,可以尝试自己编译,如果没有,可以直接下载编译好的二进制文件。

下载下来之后,发现没有后缀名无法识别,实际上这是个exe文件,所以只需要在后面加上.exe后缀就可以开始愉快使用了。

首先将README.md文档复制到gh-md-toc.exe的根目录下,接着按住shift键同时右击。

Github Markdown文件生成目录

打开Powershell窗口后,直接键入gh-md-toc.exe Base.md

Github Markdown文件生成目录

接下来只需将生成的目录粘贴到Markdown文件里面即可,如果看后面的字符不太习惯,可以解码成中文字符。

weinxin
我的微信
扫一扫加我微信
琪玥

发表评论

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen: