HTML转Markdown转换器

欢迎使用我们的 HTML 到 Markdown 转换器，这是一个免费的在线工具，可将 HTML 标记转换为纯净、易读的 Markdown 语法。无论您是将内容从 CMS 迁移到静态网站、编写文档、准备 README 文件，还是为 GitHub 或 Jekyll 等平台准备博客文章，此转换器都能精确处理标题、链接、图片、表格、代码块、列表等内容。

什么是 Markdown？

Markdown 是由 John Gruber 在 2004 年创建的一种轻量级标记语言。它使用简单的纯文本格式约定，如 # 标题、**加粗**、- 列表项 和 [链接](url)，来创建结构化文档，这些文档在原始形式下易于阅读，并且可以转换为 HTML 进行网页显示。Markdown 是 README 文件、开发者文档、博客、论坛和笔记应用程序的标准格式。

为什么要将 HTML 转换为 Markdown？

1. 内容迁移

将内容从 WordPress、Drupal 或其他基于 HTML 的 CMS 平台移动到 Jekyll、Hugo 或 Gatsby 等静态站点生成器时，需要将 HTML 转换为 Markdown。此工具可自动执行该过程。

2. 文档编写

GitHub、GitLab 和 Bitbucket 上的开发者文档使用 Markdown。将现有的 HTML 文档转换为 Markdown 使其更易于维护、进行版本控制和协作。

3. 可读性

Markdown 在原始形式下比 HTML 更具可读性。将 HTML 转换为 Markdown 使人类更容易扫描、编辑和审阅内容，而无需处理尖括号和闭合标签。

4. 便携性

Markdown 文件可在数百个平台和工具中运行。通过将 HTML 转换为 Markdown，您的内容将变得具有便携性且面向未来。

支持的 HTML 元素

如何使用此工具

1. 粘贴您的 HTML： 将您要转换的 HTML 内容复制并粘贴到左侧的输入编辑器中。您也可以点击快速示例来查看其工作原理。
2. 配置选项： 选择您喜欢的标题样式（ATX 或 Setext）、列表标记（- 或 *）和代码围栏样式（反引号或波浪号）。
3. 查看 Markdown 输出： 转换后的 Markdown 会在您键入时立即出现在右侧面板中。
4. 复制或下载： 点击“复制”将 Markdown 复制到剪贴板，或点击“下载”将其保存为 .md 文件。您还可以切换实时预览以查看 Markdown 的渲染效果。

标题样式选项

ATX 样式（默认）

ATX 样式在标题文本前使用井号 (#)。它支持所有六个标题级别，是现代 Markdown 中使用最广泛的样式：

# 标题 1 | ## 标题 2 | ### 标题 3

Setext 样式

Setext 样式在标题文本下方使用下划线。它仅支持 h1 和 h2（h3-h6 回退到 ATX）。一些作者更喜欢将其用于顶级标题，因为它在原始 Markdown 中具有视觉强调效果。

常见用例

CMS 迁移

将博客内容从 WordPress、Ghost 或 Squarespace 迁移到基于 Markdown 的平台，如 Hugo、Jekyll、Gatsby 或 Next.js。粘贴 HTML 源代码并获取可用于新网站的纯净 Markdown。

GitHub README 文件

将 HTML 文档或设计模型转换为 GitHub 仓库的 Markdown。此转换器支持 GitHub Flavored Markdown 所支持的表格、代码块和嵌套列表。

电子邮件转文档

将 HTML 电子邮件内容或网页内容转换为 Markdown 格式，用于内部文档维基或知识库。

记笔记

将网页内容转换为适用于 Obsidian、Notion、Bear 或 Typora 等应用程序的 Markdown。Markdown 笔记具有便携性且面向未来。

获得最佳效果的技巧

先清理 HTML

为了获得最佳效果，请使用不带过度内联样式的纯净 HTML。转换器侧重于语义化 HTML 结构，因此删除不必要的 style 和 class 属性会产生更简洁的输出。

检查表格对齐

具有合并单元格 (colspan/rowspan) 的复杂 HTML 表格可能无法完美转换，因为 Markdown 表格不支持单元格跨度。简单表格转换非常准确。

嵌套列表

转换器可以正确处理具有正确缩进的嵌套列表。如果您的 HTML 具有深度嵌套的列表，请检查输出以确保嵌套符合您的预期。

常见问题解答

什么是 HTML 到 Markdown 转换器？

HTML 到 Markdown 转换器是一个在线工具，可将 HTML 标记转换为等效的 Markdown 语法。它将标题、加粗、斜体、链接、图片、列表、表格和代码块等 HTML 标签转换为对应的 Markdown 形式，生成纯净且易读的纯文本格式内容。

使用此转换器时，我的 HTML 内容安全吗？

是的，完全安全。所有 HTML 到 Markdown 的转换完全在您的浏览器中使用客户端 JavaScript 完成。您的内容绝不会被发送到任何服务器、存储或传输。您的 HTML 保持完全私密。

此转换器支持哪些 HTML 元素？

此转换器支持所有常见的 HTML 元素，包括标题 (h1-h6)、段落、加粗、斜体、删除线、链接、图片、有序和无序列表、嵌套列表、表格、代码块、行内代码、块引用、水平分割线、换行符和预格式化文本。

ATX 和 Setext 标题样式有什么区别？

ATX 样式在标题文本前使用井号（例如 ## 标题 2），而 Setext 样式在标题文本下方使用下划线（例如 h2 使用一行虚线）。ATX 支持所有六个标题级别 (h1-h6)，而 Setext 仅支持 h1 和 h2。ATX 在现代 Markdown 中更常用。

我可以将 HTML 表格转换为 Markdown 吗？

可以。此转换器支持 HTML 表格，并使用管道和虚线将其转换为具有正确列对齐的 GitHub Flavored Markdown (GFM) 表格语法。它能正确处理 thead、tbody、th 和 td 元素。

其他资源

• Markdown 语法 - Daring Fireball (原始规范)
• GitHub Flavored Markdown 指南
• Markdown 指南 - 全面参考