Markdown 预览
实时渲染 Markdown,输出经 DOMPurify 消毒防 XSS
关于Markdown 预览
Markdown 用少量符号描述文档结构(# 标题、- 列表、``` 代码块),渲染后生成 HTML 页面。它在 README、技术文档、Issue 中被广泛使用,但不同渲染器对表格、脚注、HTML 混排的支持不一致,所以发布前在实际渲染器里预览一遍很有必要。
使用步骤
- 在左侧编辑器输入或粘贴 Markdown 文本
- 右侧实时渲染,滚动位置左右同步
- 需要 HTML 时切换「导出 HTML」,得到可直接嵌入页面的代码
- 发布前按目标平台(GitHub / 公众号 / 内部 wiki)各预览一遍
常见错误
表格少了分隔行
Markdown 表格第二行必须是 |---| 形式的分隔行,漏掉它整段会被当成普通文本。分隔行前后各留一个空行更稳。
代码块不标语言
``` 后面不写语言就没有语法高亮,某些平台还会按纯文本处理。标上 js、python、bash 体验差别很大。
依赖平台方言
任务列表、@提及、折叠块都是扩展语法,换个渲染器就失效。对外发布的文档坚持用标准语法最安全。
常见问题
预览里能正常显示,发到平台上却乱掉?
不同平台支持的是不同方言(GitHub Flavored Markdown、CommonMark 等)。尽量只用标准语法,避免依赖 HTML 混排和脚注。
粘贴的 HTML 会被执行吗?
不会。本工具的输出经过 DOMPurify 消毒,script 标签和事件属性都会被移除。
支持哪些扩展语法?
表格、任务列表、删除线、围栏代码块这些 GFM 扩展都支持。数学公式和 mermaid 图不在默认范围内——它们要额外的渲染器,会让首屏体积翻倍。
为什么本地预览正常,发到公众号或知乎就乱了?
因为各平台的 Markdown 方言不同:有的不支持表格,有的把 HTML 过滤掉,有的对嵌套列表的缩进要求不一样。预览只能保证「标准 GFM 下的渲染结果」,发布前要在目标平台再看一眼。
能导出成 HTML 吗?
渲染结果是真实的 DOM,可以选中复制(带格式)粘进富文本编辑器,也可以用开发者工具拷 outerHTML。要独立文件的话,把渲染结果套一层最小 HTML 骨架就行。
来源:基于开源 marked (MIT) + DOMPurify (Apache-2.0) · License: MIT · 分类:文本
相关阅读
- JSON 格式化 —— 美化/压缩 JSON,自动校验语法错误
- Base64 / URL 编解码 —— Base64 与 URL 编码互转,支持中文
- 文本对比 —— 两段文本行级差异对比,新增/删除一目了然
- 前端调试工具包 —— 专题工具包
- 写作工具箱 —— 专题工具包
- Markdown 编辑器横评:四款主流在线编辑器怎么选 —— 横评对比
- 全部文本类工具 —— 按分类浏览
安全、快捷、开源工具及资源
无需安装、无需注册、无需命令行 —— 挑一个工具,填参数,出结果。