Markdown 转 HTML
将 Markdown(GitHub 风格)转换为简洁的 HTML,并提供实时预览。可复制或下载结果,全程在浏览器中完成。
在浏览器中本地处理,你的文本不会被上传。
这个工具能做什么
粘贴 Markdown,立即得到 HTML。转换器支持 GitHub 风格的 Markdown(GFM):表格、任务列表、删除线、围栏代码块和自动链接,以及经典的标题、强调、列表、引用和链接。右侧的实时预览会显示文档的呈现效果,另一个标签页则显示原始 HTML,方便你准确复制所需内容。
典型用途包括:把 README 或文档草稿转成 HTML,用于 CMS 或邮件模板;用笔记快速生成独立的 .html 页面;或者在发布之前,先看看表格或代码块会如何渲染。通过选项,你可以把单个换行视为 <br>,关闭 GFM 以使用严格的经典 Markdown,还可以把输出包装成带少量样式的完整 HTML 文档。
转换由 marked 库在你的浏览器中完成。预览被刻意锁定:HTML 会先经过白名单清理器处理,再渲染在沙盒框架中,该框架不能运行脚本、提交表单或加载远程图片。只有在“清理”开关打开时(默认如此),导出的 HTML 才会被清理。
使用方法
- 1在左侧框中粘贴或输入 Markdown,或点击“示例”加载一段样例。
- 2观察实时预览的更新,或切换到 HTML 标签页查看标记代码。
- 3选择选项:GitHub 风格 Markdown、换行、清理导出内容,以及是否包装成完整文档。
- 4点击“复制”把 HTML 放入剪贴板,或点击“下载”保存为 .html 文件。
支持的格式
输入:Markdown 文本(带 GitHub 风格扩展的 CommonMark)。输出:HTML 片段或完整的 .html 文档。
隐私
你的 Markdown 在你的设备上转换。不会上传任何内容,预览框架处于沙盒中,即使是恶意的 Markdown 也无法运行脚本或联系服务器。
限制
- Markdown 中的原始 HTML 会被转换器原样保留。除非打开“清理”开关,否则导出的 HTML 不会被清理;只要 Markdown 来自他人,请保持开启。
- 清理器会移除脚本、iframe、表单、内联样式和事件处理程序,因此一些高级的内嵌 HTML 会在清理后的输出中被去掉。
- 预览不会加载远程图片(出于隐私考虑已被阻止)。以 data: URI 内嵌的图片可以显示;远程图片会在发布之后出现在你导出的 HTML 中。
- 不包含语法高亮、数学公式和图表扩展;代码块导出时会带有 language-xxx 类名,供你自行设置样式。
- 非常大的文档(几兆字节)可能会让输入变得迟缓,因为每次编辑都会重新渲染预览。
常见问题
输出的 HTML 可以放心发布吗?
打开“清理”开关后,脚本、iframe、事件处理程序、内联样式和 javascript: 链接会按白名单被移除。关闭后,输出就是 Markdown 转换器生成的原样内容,包括你输入的任何原始 HTML。对于来自不可信来源的未清理输出,请视为不安全。
支持表格和任务列表吗?
支持,前提是启用了 GitHub 风格 Markdown(默认开启)。表格、任务列表(- [x])、删除线(~~文本~~)和自动链接的 URL 都受支持。关闭 GFM 即可使用严格的经典 Markdown。
为什么我的换行消失了?
在标准 Markdown 中,单个换行不会产生换行效果;请在行尾加两个空格,或空出一行。启用换行选项后,每个换行都会变成 <br>,与 GitHub 评论一样。
能得到完整的 HTML 页面吗?
打开“完整文档”选项。输出会被包装上 doctype、head、UTF-8 meta 标签和一小段样式表,这样保存为 .html 文件后能正常打开。