功能介绍
Markdown 转 HTML 工具把 Markdown 文本转换成 HTML 标记,可以粘贴到 CMS、邮件模板、静态页面,或者任何只接受 HTML、不支持 Markdown 的地方。适合把 README 发布到网站、把笔记搬进博客编辑器,或者查看一段 Markdown 究竟会生成哪些标签。
输出和主流 Markdown 渲染器生成的 HTML 一致:<h1> 到 <h6> 标题、<p> 段落、<ul> 和 <ol> 列表、带 language- class 的 <pre><code> 代码块(方便语法高亮),以及 GitHub 风格表格对应的 <table>。
使用方法
- 输入或粘贴 Markdown、上传
.md文件,或点「示例」。 - 按需选择选项:GitHub 风格 Markdown、单个换行转
<br>、用于锚点链接的标题 ID、针对不可信内容的安全过滤,以及输出完整 HTML 页面而不是片段。 - 复制 HTML,或下载为
.html文件。
结果会随输入实时更新。要把结果粘贴进已有页面时关闭完整页面选项,需要独立文件时再打开。
示例
这段 Markdown:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOS
会转换成以下 HTML:
<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul>
<li>Windows</li>
<li>macOS</li>
</ul>
小贴士
- 默认情况下 Markdown 里的原始 HTML 会原样保留,这也是大多数渲染器的做法。只要 Markdown 是别人写的,就打开安全过滤。
- 打开标题锚点后,可以用
page.html#install这样的地址链接到某个小节,也可以根据标题生成目录。 - 代码块的语言会保留为 class,Prism、highlight.js 等高亮库不用额外配置就能识别。
- 想并排预览渲染效果,可以用 Markdown 预览工具;反向转换可以用 HTML 转 Markdown 工具。
常见问题
› 支持哪些 Markdown 语法?
支持全部 CommonMark 语法,包括标题、强调、链接、图片、列表、引用、代码和分隔线。打开 GitHub 风格 Markdown 后,还支持带对齐的表格、任务列表、删除线和裸网址自动链接。
› 安全过滤选项有什么用?
它会把 Markdown 里的原始 HTML 转义成文字显示,而不是变成标签,并删除使用 javascript、vbscript 等不安全协议的链接和图片。Markdown 来自不可信的用户时(比如评论、论坛帖子)应当打开。
› 标题锚点 ID 是怎么生成的?
和 GitHub 的规则一样。标题文字转小写、去掉标点、空格换成连字符,所以 Getting Started 的 id 是 getting-started。重复的标题会加上 -1、-2 等后缀,保证每个锚点唯一。
› 完整 HTML 页面选项有什么用?
它会把结果包成一个完整页面,带 doctype、UTF-8 字符集、viewport 标签、取自第一个一级标题的 title,以及一小段易读的样式。保存成 .html 文件后,在任何浏览器里都能直接打开。
› 我的 Markdown 会被上传吗?
不会。转换在浏览器中用 marked 库完成,不会上传到服务器。