Markdown 预览

实时渲染 Markdown,输出经 DOMPurify 消毒防 XSS

关于Markdown 预览

Markdown 用少量符号描述文档结构(# 标题、- 列表、``` 代码块),渲染后生成 HTML 页面。它在 README、技术文档、Issue 中被广泛使用,但不同渲染器对表格、脚注、HTML 混排的支持不一致,所以发布前在实际渲染器里预览一遍很有必要。

使用步骤

  1. 在左侧编辑器输入或粘贴 Markdown 文本
  2. 右侧实时渲染,滚动位置左右同步
  3. 需要 HTML 时切换「导出 HTML」,得到可直接嵌入页面的代码
  4. 发布前按目标平台(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 · 分类:文本

相关阅读

← 返回 ToolHub 全部工具

✦ OPEN SOURCE TOOLS ✦

安全、快捷、开源工具及资源

无需安装、无需注册、无需命令行 —— 挑一个工具,填参数,出结果。

99 个工具 · 50 条资源 · 文件拖进来、内容粘进来都能用 · 无需注册
运行方式排序共 99 个
🔒 为什么本地执行更放心这一条是我们和多数工具站的根本区别
数据不出设备图片、Token、表格都在你的浏览器内处理,服务端不接触你的输入
没有账号体系不注册、不收邮箱、不做用户画像,收藏与记录只存在本机
可离线使用安装为桌面/手机应用后,断网也能运行全部本地工具