杰基尔 是一款静态网站生成器，它采用 Markdown 文件并将它们转换为网站。杰基尔是一款使用 Ruby 编程语言编写的免费开源应用程序。包括《Markdown 指南》在内的数千个网站依靠杰基尔将 Markdown 源文件转换为 HTML 输出。GitHub Pages 使用杰基尔作为其免费网站创建服务的后台。
默认情况下，杰基尔使用具有库存设置的 kramdown Markdown 处理器，但你可以启用其他 kramdown 选项，甚至可以将杰基尔切换到另一个 Markdown 处理器。有关更多信息，请参阅 杰基尔 Markdown 配置选项 文档。你可以在 _config.yml 文件中更改杰基尔的 kramdown 设置。下面显示了《Markdown 指南》的设置。
kramdown:
syntax_highlighter: rouge
input: GFM
auto_ids: true
toc_levels: 1..3
杰基尔 Markdown 支持
杰基尔为以下 Markdown 元素提供支持。
| 元素 | 支持 | 备注 |
|---|---|---|
| 标题 | 是 | |
| 段落 | 是 | |
| 换行符 | 是 | |
| 粗体 | 是 | |
| 斜体 | 是 | |
| 引用块 | 是 | |
| 有序列表 | 是 | |
| 无序列表 | 是 | |
| 代码 | 是 | |
| 水平线 | 是 | |
| 链接 | 是 | |
| 图片 | 是 | |
| 表格 | 是 | |
| 带围栏的代码块 | 是 | |
| 语法高亮显示 | 是 | 确保 syntax_highlighter: rouge 位于 _config.yml 文件的 kramdown 部分中。
|
| 脚注 | 是 | |
| 标题 ID | 是 | |
| 定义列表 | 是 | |
| 删除线 | 是 | 你可以使用两个波浪号 (~~word~~) 或一个波浪号 (~word~) — 两者都可以。
|
| 任务列表 | 是 | |
| 表情符号（复制并粘贴） | 是 | |
| 表情符号（简码） | 否 | 默认情况下不支持，但你可以使用 jemoji 插件来启用支持。 |
| 高亮 | 否 | |
| 下标 | 否 | |
| 上标 | 否 | |
| 自动 URL 链接 | 是 | |
| 禁用自动 URL 链接 | 是 | |
| HTML | 是 |
支持其他语法元素
作为一项额外福利，Jekyll 提供对几个晦涩元素的支持。
| 元素 | Markdown | 呈现输出 |
|---|---|---|
| 缩写 | *[HTML]: 超文本标记语言HTML 规范由 W3C 维护。 |
由 W3C 维护的 HTML 规范。 |
另请参阅
将你的 Markdown 技能提升到一个新的水平。
60 页学会 Markdown。Markdown 指南 一书专为新手和专家设计，是一份综合参考，包含入门和掌握 Markdown 语法所需的一切内容。
获取本书想了解更多 Markdown 内容吗？
不要就此止步！🚀 为 GitHub 存储库 标星，然后在下方输入你的电子邮件地址，通过电子邮件接收新的 Markdown 教程。绝无垃圾邮件！