jekyll自动生成目录的几种方案
jekyll 的kramdown
不支持[TOC]
自动生成目录的方式,目前了解来看有几种方案:
在正文中添加如下标签,这个方案优点在于不需要额外配置,github pages 也默认支持,缺点在于格式看着不太优雅,不符合markdownlint规范,在
visual studio code
的 markdownlint 插件下会导致一堆 lint 告警;
jekyll 的kramdown
不支持[TOC]
自动生成目录的方式,目前了解来看有几种方案:
在正文中添加如下标签,这个方案优点在于不需要额外配置,github pages 也默认支持,缺点在于格式看着不太优雅,不符合markdownlint规范,在visual studio code
的 markdownlint 插件下会导致一堆 lint 告警;
Markdown是一种轻量级标记语言,旨在通过易读易写的纯文本格式来编辑文档,并可转换生成格式化的文档。
Markdown 最早由 John Gruber 于 2004 年创立。2014 年发布的 CommonMark 是第一套严谨的规范。2017 年,GitHub 发布了基于 CommonMark 的 GitHub Flavored Markdown(GFM)的正式规范。