/images/avatar.jpg

PlutoTree's Blog

jekyll自动生成目录的几种方案

jekyll 的kramdown不支持[TOC]自动生成目录的方式,目前了解来看有几种方案:

  1. 在正文中添加如下标签,这个方案优点在于不需要额外配置,github pages 也默认支持,缺点在于格式看着不太优雅,不符合markdownlint规范,在visual studio code的 markdownlint 插件下会导致一堆 lint 告警;

Markdown 语法详解

Markdown 简介

Markdown是一种轻量级标记语言,旨在通过易读易写的纯文本格式来编辑文档,并可转换生成格式化的文档。

Markdown 最早由 John Gruber 于 2004 年创立。2014 年发布的 CommonMark 是第一套严谨的规范。2017 年,GitHub 发布了基于 CommonMark 的 GitHub Flavored Markdown(GFM)的正式规范。