如何在浏览器里把 Markdown 转成 HTML
把 README、变更说明和知识库草稿一键变成可粘贴进 CMS 的 HTML 片段——本地处理,适合不方便跑本地构建环境的电脑。

为什么有用
团队在 Git 里写 Markdown,但企业 CMS 只收净化后的 HTML;支持人员在工单里贴 fenced code,后台却过滤失败;市场同学先用 Markdown 飞快起草,再交给设计师填进邮件模板。本地转换可以避免把保密草案上传到来历不明的「在线 MD 转 HTML」。
三类场景
写完 Markdown,转成片段后嵌入 Astro/React 局部组件。
直接可用的 HTML
将排查步骤转成 <ol> + <pre>,再写入知识库 HTML。
归档更清晰
在受限编辑器外预览标题层级与锚点行为。
少踩所见即所得坑
操作步骤
打开 Markdown 转 HTML。
按常用语法撰写
标题、列表、链接、围栏代码、引用等;若 CMS 白名单有限,避免使用不被允许的扩展。
选择渲染选项
若目标平台兼容 GitHub Flavored Markdown,可开启表格、删除线等扩展。
检查预览
留意列表嵌套、裸链自动识别等细节是否符合预期。
复制 HTML 片段
在无 Node 环境的电脑上也能快速交付。
Input
## Rollout checklist
1. Enable **feature flag** `payments.v2`
2. Monitor `/health/payments` for 15 minutes
3. Run: kubectl rollout status deploy/payments-apiOutput
<h2>Rollout checklist</h2>
<ol>
<li>Enable <strong>feature flag</strong> <code>payments.v2</code></li>
<li>Monitor <code>/health/payments</code> for 15 minutes</li>
<li>Run: kubectl rollout status deploy/payments-api</li>
</ol>实用技巧
常见误区
常见误区
原始 HTML 直通
若扩展允许裸 HTML,可能与净化策略冲突——先在沙箱 CMS 里验证。
常见误区
相对链接不变
迁移域名后相对路径仍指向旧站——上线前全局检查。
常见误区
缩进代码块
缩进式代码块与围栏代码块规则不同,出问题先核对 Markdown 规范。
不适合的场景
- 完整静态站点流水线:Eleventy、Astro 等有目录级能力。
- 邮件 HTML:需要内联样式与表格布局,另有专用工具链。
- 精细排版 PDF:LaTeX 等更合适。
常见问题
会调用后端接口吗?
解析在浏览器本地执行,适合含保密条款的草案。
能否 HTML 反向转 Markdown?
本教程侧重 MD→HTML;逆向清理建议用专门工具处理遗留 CMS 导出。
支持哪种方言?
按页面可选开关对齐 GitHub Flavored 等行为;实验性扩展请逐项验证。