DataHub Tools HTML 转 Markdown

HTML 转 Markdown 工具

本地优先

将常见 HTML 标题、链接、列表、代码和表格转换为 Markdown。

工具实际如何工作?

转换器使用 DOMParser 解析 HTML,并为标题、段落、强调、代码、链接、列表项、换行和第一个表格提供明确规则。不支持的结构可能被扁平化或省略,因此它不是高保真网页迁移工具。

  • 转换常见文本元素
  • 转换基础链接、代码和列表项
  • 转换第一个简单表格

如何使用?

  1. 粘贴受控 HTML 片段,而不是完整不可信网页。
  2. 转换后核对标题、链接、列表、代码和第一个表格。
  3. 人工检查有序和嵌套列表、图片、引用、脚本、样式和合并单元格。
  4. 发布或导入前继续编辑 Markdown。

快速示例

示例输入

<h2>指南</h2><p>请<strong>认真</strong>阅读。</p><ul><li>第一项</li><li>第二项</li></ul>

预期结果

## 指南

请**认真**阅读。

- 第一项
- 第二项

有序列表目前会变成无序项,嵌套列表会被扁平化,图片和引用等不支持元素可能丢失。

适合哪些场景?

  • 把简单文章片段转为 Markdown 草稿。
  • 从受控 HTML 中提取可读文本结构。
  • 为编辑准备基础标题、段落、链接和列表。

参考标准与适用边界

HTML 与 CommonMark 的内容模型不同;浏览器还可能在转换前修复畸形 HTML,因此输出可能与源标记不同。

来源核验日期:2026 年 7 月 24 日。规范与平台行为可能更新,正式使用前请复核来源。

已知限制

  • script、style、template 和 noscript 节点会被排除。
  • 只有第一个表格会走专用表格转换。
  • rowspan 和 colspan 会先展开,但合并单元格语义仍会被扁平化。

FAQ

会保留所有 HTML 元素吗?

不会。工具只处理明确的基础子集,不支持结构会丢失或扁平化。

有序列表会保留吗?

不会。当前列表项会输出为无序 Markdown 项。

图片会转换吗?

不会。当前明确转换规则不保留图片语法。

HTML 错误一定会报错吗?

不一定。DOMParser 经常会在转换器读取前自动修复畸形 HTML。