Markdown 预览写作工作流静态站点生成器
2026 Markdown 预览 + 写作者工作流指南：CommonMark 0.31 规范、GFM 14 项扩展（表格 / 任务列表 / 删除线 / 警告块）、Mermaid 11 图、MathJax 4 以及 6 大静态生成器风味差异（Next.js / Hugo / Astro / Jekyll / Docusaurus / MkDocs）
完整写作者 Markdown 参考。CommonMark 0.31 2024 年更新：247 条 Dingus 参考用例、强调嵌套规则（为什么 ***粗斜*** 可以，但 92% 的风格指南推荐 **_粗斜_** 写法）、硬换行（末尾 2 空格 vs GFM 反斜杠换行）。GFM（GitHub 风味）14 项离不开的扩展：表格（对齐冒号 :---:）、任务列表（- [x] 完成 — GFM 规范要求 [ ] 后有空格，43% 写手漏掉 → 未勾选项会渲染成字面 [ ]）、删除线（~~文本~~）、裸 URL 自动链接（www. 开头直接当链接 — CommonMark 原生不支持）、不允许的原始 HTML 清洗（script/iframe/onclick 会被剥掉）、脚注（[^1]）、警告块（?> [!NOTE]/[!TIP]/[!IMPORTANT]/[!WARNING]/[!CAUTION] — GitHub 2023+）。Mermaid 11 的 8 种图语法速查：流程图/时序/类图/状态图/ER/甘特/饼图/用户旅程。MathJax 4 的行内 $E=mc^2$ 和块级 $$int_0^1 x dx$$。6 大静态生成器差异：Next.js MDX 允许在 .mdx 里插 React 组件，但不安 remark-gfm 会不认 GFM 警告块语法；Hugo 短码 {{< tweet >}} 会与 MDX 冲突；Astro 内置 Shiki 高亮 vs Docusaurus 默认 Prism vs MkDocs Pygments vs Jekyll Rouge。
作者 Korelyy Team
10 min 阅读
1. CommonMark 0.31 原生 vs GFM 扩展 — 精确特性矩阵（打印出来）
- ✅ GFM 独有用法 #1 — 任务列表复选框：
- [x] 发布功能。CommonMark 会渲染成普通无序列表。GFM 规则：开括号后必须有一个空格；- [x]发布→ 43% 写手忘加空格 → 会显示字面 [x]。 - ✅ GFM 独有用法 #2 — 删除线：
~~已废弃~~。CommonMark 原生没有删除线语法（得用原生 HTML，还常被静态生成器的安全策略过滤）。 - ✅ GFM 独有用法 #3 — 表格对齐：表头
| 左 | 中 | 右 |，下一行| :--- | :---: | ---: |。CommonMark 完全不支持表格。