HTML to Markdown

转换器支持标题（h1–h6）、段落、粗体、斜体、删除线、行内代码、围栏代码块、引用块、水平分割线、链接、图片、有序列表、无序列表、嵌套列表和表格——覆盖CommonMark和GitHub Flavored Markdown（GFM）的完整功能集。div、section、article等未知结构性元素会透明传递其子内容，确保内容不丢失。来自CMS导出、抓取的文章或文档页面的大多数实际HTML均可干净转换，无需您进行任何后处理。

Pandoc是功能强大的命令行转换器，但需要安装、终端操作以及了解其参数选项。它适合自动化服务端流水线，对于一次性转换来说过于复杂。Turndown.js是最常用的JavaScript HTML转Markdown库——每周npm下载量超过250万次，GitHub Stars超过10800——本工具采用相同的基于DOM的解析方式，具备同等可靠性。区别在于一切都在您的浏览器中运行：无需安装，无需命令行，无需服务器往返，文件不会离开您的设备。Turndown.js需要配置Node项目；本工具则不需要。

Markdown是技术写作、文档撰写和内容管理的标准纯文本格式。将HTML转换为Markdown后，您可以将内容导入Notion或Obsidian，将其与代码一起提交到Git仓库，通过Astro、Hugo或Jekyll等静态网站生成器发布，或输入AI模型和大语言模型。2024年发布的研究表明，与原始HTML相比，Markdown在与大语言模型配合使用时可将Token用量减少68–87%——在构建RAG管道或准备微调数据集时，这是真实的成本和准确性差距。

可以——CMS迁移是最常见的专业使用场景之一。粘贴从WordPress、Confluence、SharePoint、Ghost或任何其他平台导出的HTML，即可获得可导入新系统的干净Markdown。WordPress的导出提供HTML内容块；Confluence将页面导出为HTML或XHTML——两者均可干净转换。为获得最佳结果，建议只粘贴内容正文，而不是包含导航和页脚的完整页面HTML。团队已使用浏览器端HTML转Markdown转换在两天内完成了150–200页文档站点的迁移，完全无需使用命令行。

表格转换为GitHub Flavored Markdown（GFM）管道表格格式，标题行后有一行短横线分隔行。该格式适用于GitHub、GitLab、VS Code预览、Notion、Obsidian、Docusaurus及几乎所有现代Markdown渲染器。嵌套表格会被扁平化，因为标准Markdown原生不支持嵌套表格。列对齐方式——通过align属性或CSS的text-align设置的左对齐、居中、右对齐——通过分隔行中的冒号位置保留（例如：:--- 表示左对齐，:---: 表示居中，---: 表示右对齐）。

支持。转换完全在您的浏览器中使用内置DOM解析器完成——没有文件被上传，页面加载后也不需要网络连接。这使其可以安全处理机密HTML，如内部文档、专有API参考或不应离开您设备的客户资料。您可以验证这一点：打开浏览器开发者工具，切换到网络选项卡，确认粘贴HTML并触发转换时没有任何网络请求发出。没有任何数据离开您的设备。

它会删除Markdown输出中每行末尾的空格和制表符，并将多个连续空行合并为单个空行。这保持文件整洁，避免可能影响严格Markdown解析器渲染的不可见空白字符——尤其是GitHub，它会将尾随空白标记为lint问题。这也使输出更易于直接放入运行空白检查的文档工具中。几乎所有情况下都可以安全启用此选项。只有极少数情况下尾随空白才具有语义意义。

可以。嵌套的ul和ol元素会被递归处理，每个层级在Markdown输出中都有正确的缩进。混合嵌套——有序列表嵌套在无序列表中，或反之——也能正确处理。例如，有序列表中的三级嵌套无序列表，每个层级都会获得正确的四个空格缩进，这是CommonMark标准。这是基于正则表达式的转换器经常出错并产生损坏Markdown的边缘情况之一，而基于DOM的解析则能可靠地处理。

输出遵循CommonMark规范，并带有GitHub Flavored Markdown（GFM）扩展，支持表格和删除线。CommonMark是大多数平台使用的标准规范，GFM添加了管道表格语法和GitHub、GitLab、VS Code均支持的~~删除线~~。这使输出兼容GitHub、GitLab、VS Code、Notion、Obsidian、Docusaurus、MkDocs及大多数现代Markdown渲染器。如果您需要不含GFM扩展的严格CommonMark，表格是唯一会有差异的元素——其他所有内容完全相同。

您可以粘贴任何HTML片段或完整页面主体。为获得最佳效果，建议只粘贴主要内容区域，而不是包含导航、侧边栏和页脚的完整文档，以确保输出专注于有意义的内容。大多数开发者从浏览器开发者工具的元素面板中复制文章或文档的div（右键 → 复制 → 复制outerHTML）。这样可以获得干净的内容HTML，去除结构性页面框架。转换器也支持完整页面HTML，但输出将包含转换为链接平铺列表的导航文本，这通常不是您想要的结果。

Perplexity、ChatGPT和Gemini等AI系统现在会读取、分块并重用网络内容来生成答案。Markdown是它们首选的输入格式，因为它剥去了消耗Token却不增加语义含义的HTML结构标签。用<p class="article-body">标签包裹的段落比同一段落的纯Markdown消耗更多Token。2024年发布的研究表明，对于相同内容，Markdown与原始HTML相比可将Token用量减少68–87%——这直接降低了API成本，并提高了检索增强生成（RAG）管道的信噪比。

行内代码元素（不在pre中的code标签）用单个反引号包裹。代码块（pre > code元素）用三个反引号的围栏块包裹，这是CommonMark和GFM标准。如果code元素有如'language-python'或'lang-python'这样的class，语言标识符会被提取并保留在开头围栏中用于语法高亮。从GitHub README页面或文档站点转换的代码块会在输出中保留其语言标签——因此HTML中的语法高亮在Markdown中得以保留。

Markdownify和h2m是用于在构建流水线中以编程方式进行HTML转Markdown转换的Node.js npm包。当您需要在脚本中自动转换数百个文件时，它们是正确的选择。本浏览器工具覆盖了它们不擅长的使用场景：快速一次性转换、无法分享给服务器的内容，以及完全不想配置Node项目的情况。转换质量相近——三者都使用基于DOM的解析而非正则表达式——但本工具添加了实时预览、复制按钮和字符/字数统计，使其更适合内容工作。

可以，转换器在移动端浏览器上完全正常工作。从剪贴板粘贴HTML，触发转换，复制Markdown结果——全程可在手机或平板上完成。界面会适应较小屏幕，面板纵向排列。已在iOS 17的Safari和Android 14的Chrome上测试通过。一个常见的移动端使用场景：从浏览器的分享菜单获取文章HTML，转换后直接将Markdown粘贴到同一设备上的Obsidian或Notion，完全无需桌面电脑。无需注册，无需下载应用，无使用限制。

HTML注释（<!-- ... -->）会从输出中删除，因为Markdown没有注释语法，且注释很少是实际内容的一部分。Script标签及其内容也会被丢弃——JavaScript在Markdown中没有意义。Style标签和内联style属性也会被移除；CSS样式无法转换为Markdown，语义含义（粗体、斜体、标题）通过元素类型而非视觉样式来保留。如果span通过CSS而非strong或b标签实现粗体效果，该样式不会被保留——这对于内容格式转换来说是正确的行为。

没有。没有服务器参与，因此除浏览器内存限制外没有任何大小限制。实际上，浏览器DOM解析器可以处理数兆字节的HTML而不出现问题——远超任何真实CMS页面的大小。如果您正在转换极大的HTML文件（完整的书籍导出、非常长的抓取文章），分段粘贴而非一次性全部粘贴可获得更清晰的输出。转换本身无论文件大小都在毫秒级完成，因为它直接在浏览器标签页的JavaScript中运行。