2026-05-19 · 约 1 分钟阅读
文档站的 Markdown 转 HTML
用于预览的转换；生产 HTML 仍应走静态站点生成器。
MarkdownHTML文档
要点
- 表格、脚注等与 SSG 可能不一致——输出仅作近似。
- 渲染用户 Markdown 时必须消毒 HTML。
预览流程
Markdown 起草 → 转 HTML 给评审 → 需要时用 HTML Formatter 美化。
嵌入 API 响应前对 HTML 做实体编码。
常见问题
是否 CommonMark 完全兼容？
覆盖常见博客/文档语法，非全部扩展。请对照你的渲染器验证。
HTML 转回 Markdown？
简单页面支持；复杂布局需手工整理。