许多 Markdown 生成器都有 TOC（大纲）功能，将文章的标题提取出来，做成一个带有 HTML 元素 id 的链接清单，点击后就会跳转到对应标题的位置。
由于 CommonMark 没有规定过 TOC 功能，自然各种 Markdown 生成器对此有不同的策略，有的直接照搬，将标题内容转化为 HTML 元素 id，有的将大写字母转为了小写，还有的仅保留 ASCII，并将空格替换为短横线，总之这个 TOC 功能，在各个 Markdown 生成器里各不相同，要实现「一次编写，到处运行」，还有很远的路。
GitHub 默认不把 Markdown 记入统计，所以你的文本仓库，很可能被 CSS, yaml 等文件抢了风头。所以要成为真正的 Markdown 工程师，应该在仓库里添加一个文件 .gitattributes，内容为：
.md linguist-detectable=true
.md linguist-documentation=false
这样就会像标题图，Alexandre Sanlim 的 GitHub 主页一样，出现 Markdown 编写的仓库了。