HTML 转 Markdown 转换工具
粘贴 HTML,获得保留结构的 Markdown:标题、粗体和斜体、链接、图片、列表、引用、代码块和简单表格。脚本、样式和布局包装元素会被去除,页面会显示结果缩短了多少。免费,无需注册,HTML 在您的浏览器中解析,从不上传。
如何使用 HTML 转 Markdown 转换工具
- 1. 粘贴您的 HTML。 片段或完整页面都可以;只转换 body 部分。
- 2. 点击“转换为 Markdown”。 Markdown 会显示在下方,并附有三个计数器:HTML 字符数、Markdown 字符数和体积缩减。
- 3. 检查结果。 对照原文阅读,尤其要检查表格和嵌套列表(见下方的局限)。
- 4. 复制。 点击复制 Markdown即可将文本复制到剪贴板,随时可用于 README、静态站点生成器或笔记应用。
每个 HTML 元素会变成什么
本工具使用浏览器自带的 HTML 解析器解析您的 HTML 并遍历其树结构,因此格式错误的标记会像浏览器那样被修复。随后,每个元素会映射为对应的 Markdown 语法:
| HTML | Markdown |
|---|---|
h1 到 h6 | # 到 ######,后接标题文字 |
p | 以空行分隔的段落 |
br、hr | 换行;--- |
strong、b | **bold** |
em、i | *italic* |
code | 以单个反引号包裹的文本 |
pre | 以三个反引号围成的代码块,不带语言标签 |
a | [text](address) |
img |  |
ul、ol | - 项目符号,或从 1 开始重新编号的 1. 2. 3.;子列表每级缩进两个空格 |
blockquote | 每行前加上 > |
table | 管道符表格;第一行成为表头 |
div、span、section 及其他 | 解包:去掉标签,保留其内容 |
script、style、head、meta、link、title、noscript、template、iframe | 连同其内容一并删除 |
示例
HTML
<h1>Citation Basics</h1><p>Use <strong>APA</strong> or <em>MLA</em>; see the <a href="https://apastyle.apa.org">APA site</a>.</p><ul><li>Author</li><li>Year<ul><li>Month</li></ul></li></ul><table><tr><th>Style</th><th>Year</th></tr><tr><td>APA</td><td>7th</td></tr></table>
Markdown
一个 # Citation Basics 标题;一段文字为 Use **APA** or *MLA*; see the [APA site](https://apastyle.apa.org). 的段落;列表 - Author、- Year 以及缩进的 - Month;然后是一个两列的管道符表格,带有 --- 分隔行和一行数据(APA 与 7th)。
计数器
273 个 HTML 字符,159 个 Markdown 字符,缩减 42%。
Markdown 无法表达 HTML 能表达的一切,这正是它的意义所在:输出的是文档的结构,而不包含任何呈现方式。
需要检查的局限
- 表格会被压平。 每个单元格都会被简化为纯文本,因此单元格内的链接和强调会丢失,管道符会被转义,合并的单元格也无法识别。管道符表格属于 GitHub Flavored Markdown 扩展,而非 CommonMark 核心语法的一部分,因此请确认您的目标平台是否支持。
- 部分行内标签会被删除。 下划线、删除线、上标和下标在此没有对应的 Markdown 语法,因此它们的文本会被保留,但不带格式。
- 特殊字符不会被转义。 您文本中字面的星号或下划线会保持原样,可能会被 Markdown 渲染器当作强调符号解析。
- 嵌套的有序列表每级缩进两个空格。大多数渲染器可以接受,但有些渲染器要求在
1.标记下缩进三个空格。 - 链接和图片保留其原始地址,因此相对路径仍为相对路径。
您需要哪个工具?
当从 HTML 转换为 Markdown 且需要保留结构时,请使用本页。如果您只需要文字,请使用 HTML 标签移除工具,它输出纯文本。反过来,Markdown to HTML Converter 可以将 Markdown 渲染为 HTML,Markdown 转文本 可以将 Markdown 去除格式变为纯文本。若要在转换前整理 HTML,请使用 HTML Formatter。
常见问题
- 哪些 HTML 元素会被转换为 Markdown?
- 标题、段落、换行、水平线、粗体、斜体、内联代码、代码块、链接、图片、有序和无序列表、引用块以及简单表格。上面的表格列出了确切的对应关系。
- 它能处理嵌套列表吗?
- 能。子列表每级缩进两个空格,有序列表会从 1 开始重新编号。HTML 中从其他数字开始的列表,例如
start="5",同样会从 1 开始重新编号。 - 无法识别的标签会怎样处理?
- 它们会被解包:标签被去掉,其文本被保留。div 或 span 会无痕消失,而 script、style 及类似元素则会连同其内容一并删除。
- 它能转换 HTML 表格吗?
- 能转换简单表格:它们会变为管道符表格,第一行作为表头。合并单元格、嵌套表格,以及单元格内的链接或格式都不会被保留。
- 它能处理整个网页吗?
- 可以,但它会把 body 中的所有内容(包括导航菜单和页脚)都当作普通文本和链接进行转换。对于文章,请只粘贴文章的 HTML。
- 为什么 Markdown 看起来比原始页面更简单?
- Markdown 记录的是结构,例如标题、强调、链接和列表,而不是颜色、字体或布局。CSS、表单和嵌入式组件按设计会被舍弃。
- 我的 HTML 会被上传到服务器吗?
- 不会。转换使用浏览器内置的 DOMParser 在您的浏览器中完成,它不会运行粘贴的 HTML 中的脚本,您粘贴的任何内容都不会离开您的设备。