Jekyll

Jekyll (opens new window) 是一个静态站点生成器，它接收 Markdown 文件并将其转换为网站。Jekyll 是一个免费的开源应用程序，使用 Ruby 编程语言编写。数千个网站（包括 《Markdown 指南》）都依赖 Jekyll 将 Markdown 源文件转换为 HTML 输出。GitHub Pages 使用 Jekyll 作为其免费网站创建服务的后端。

默认情况下，Jekyll 使用 kramdown (opens new window) Markdown 处理器及其默认设置，但您可以启用其他 kramdown 选项，甚至将 Jekyll 切换到另一个 Markdown 处理器。有关详细信息，请参阅 Jekyll Markdown 配置选项 (opens new window) 文档。您可以在 _config.yml 文件中更改 Jekyll 的 kramdown 设置。以下是 《Markdown 指南》 的设置示例。

kramdown:
  syntax_highlighter: rouge
  input: GFM
  auto_ids:       true
  toc_levels:     1..3

Jekyll Markdown 支持

Jekyll 支持以下 Markdown 元素。

功能	支持	备注
标题	是
段落	是
换行	是
粗体	是
斜体	是
引用块	是
有序列表	是
无序列表	是
代码	是
水平线	是
链接	是
图片	是
表格	是
围栏代码块	是
语法高亮	是	确保 _config.yml 文件的 kramdown 部分中包含 syntax_highlighter: rouge
脚注	是
标题 ID	是
定义列表	是
删除线	是	可以使用双波浪号（~~文字~~）或单波浪号（~文字~）——两者都可以
任务列表	是
表情符号（复制粘贴）	是
表情符号（短代码）	否	默认不支持，但可以使用 jemoji (opens new window) 插件启用支持
高亮	否
下标	否
上标	否
自动 URL 链接	是
禁用自动 URL 链接	是
HTML	是

额外语法支持

作为额外功能，Jekyll 还支持以下特殊元素。

元素	Markdown	渲染输出
缩写	*[HTML]: 超文本标记语言 HTML 规范由 W3C 维护。	HTML 规范由 W3C 维护。

另见

• Jekyll Markdown 配置选项 (opens new window)
• kramdown 文档 (opens new window)