HTML 转 Markdown

What

HTML 转 Markdown 定义

HTML 转 Markdown 是把用于渲染的标记还原为可移植的纯文本 Markdown 的过程。该工具在浏览器中把 HTML 解析成 DOM，并把每个元素映射为最接近的 CommonMark 或 GitHub Flavored Markdown 写法。

Cases

常见使用场景

1

把旧 CMS 中的文章迁移到基于 Markdown 的静态站点

2

把文档页面转成 README 或 Wiki 内容

3

把富文本编辑器的输出清洗后再提交到 Git

4

把邮件或文档里复制的 HTML 整理成 Issue 正文

5

从 HTML 报表中提取 GFM 表格用于更新日志

6

把 HTML 片段整理成精简的 Markdown 作为 LLM 提示上下文

How To

如何把 HTML 转成 Markdown

粘贴 HTML，选择 Markdown 风格选项，然后复制结果。

1

粘贴 HTML

把完整文档或单个片段粘贴到 HTML 输入框中。

2

选择选项

选择项目符号、标题风格，以及未支持标签的处理方式。

3

检查结果

确认标题、列表、表格和代码块是否符合预期。

4

复制使用

把生成的 Markdown 复制到 README、CMS 或文档仓库中。

Knowledge

HTML 转 Markdown 基础

遍历器如何工作

HTML 先被解析为 DOM，然后逐个节点遍历。块级元素会变成用空行分隔的 Markdown 块，行内元素会被 ** 或反引号包裹，空白也按浏览器的规则折叠。

Markdown 方言差异

标题、列表和强调遵循 CommonMark，而表格与删除线遵循 GitHub Flavored Markdown。不支持 GFM 的渲染器会把管道表格显示为纯文本，使用前请先确认目标渲染器。

安全与边界情况

script、style、noscript 元素、注释、行内事件属性以及 javascript: URL 都会在转换前被剥离，格式错误的标记也会回退为纯文本而不是抛出异常。如果选择保留原始 HTML，渲染前请再次做一次清洗。

FAQ

常见问题

支持哪些 HTML 元素？

标题、段落、列表、表格、引用、链接、图片、代码块以及行内格式都会转换为 Markdown，其余元素会被拆除标签或保留为原始 HTML。

粘贴的 HTML 会执行脚本吗？

不会。解析过程不执行脚本，并且 script、style、noscript 元素和注释会在转换前被移除。

表格如何转换？

表格会转换为 GFM 管道表格，列对齐方式取自 align 属性或 text-align 样式。

为什么有些字符前多了反斜杠？

*、_、[ 等字符在 Markdown 中有特殊含义，转义后才能原样显示文本。

代码语言会保留吗？

会。code 元素上的 language-ts 之类的类名会写入代码围栏的语言标识。

我的 HTML 会离开浏览器吗？

不会。整个转换都在本地完成，不会上传任何内容。

HTML 转 Markdown

HTML 转 Markdown 定义

常见使用场景

如何把 HTML 转成 Markdown

粘贴 HTML

选择选项

检查结果

复制使用

HTML 转 Markdown 基础

常见问题

转换 工具

HTML 转 Markdown

HTML 转 Markdown 定义

常见使用场景

如何把 HTML 转成 Markdown

粘贴 HTML

选择选项

检查结果

复制使用

HTML 转 Markdown 基础

常见问题

转换工具