HTML 转 Markdown 工具

什么是HTML转Markdown工具？

HTML转Markdown工具是一款将HTML格式文本转换为Markdown纯文本格式的在线实用工具。Markdown是一种轻量级标记语言，由John Gruber于2004年创建，凭借其简洁易读的语法，被广泛应用于技术文档、博客写作、笔记记录、README文件等场景。当你从网页复制富文本内容、从Word导出HTML、或需要将现有HTML页面转为可维护的Markdown文档时，本工具可以帮你快速完成格式转换，节省大量手动编辑的时间。

支持的HTML元素转换

本工具支持绝大多数常见HTML标签到Markdown的转换，具体包括：

• 标题：h1-h6 → # ###### 对应层级的Markdown标题
• 文本格式：strong/b → **加粗**，em/i → *斜体*，del/s → ~~删除线~~
• 链接：a标签 → [链接文本](URL "可选标题")
• 图片：img标签 → 
• 列表：ul/ol/li → 无序列表和有序列表，支持嵌套
• 代码：code → `行内代码`，pre → ```代码块```
• 引用：blockquote → > 引用块
• 表格：table → Markdown表格（含表头和对齐）
• 水平线：hr → ---
• 换行：br → 两个空格+换行或硬换行
• 段落：p → 段落间空行分隔

如何使用HTML转Markdown工具

1. 粘贴HTML代码 — 在左侧输入框中粘贴需要转换的HTML代码，支持完整HTML文档或片段。
2. 配置转换选项 — 勾选或取消对应的转换选项，如是否转换表格、列表等。
3. 点击转换 — 点击"转换"按钮，右侧输出框将显示转换后的Markdown文本。
4. 复制或下载 — 使用复制按钮将结果复制到剪贴板，或下载为.md文件保存。

常见使用场景

场景一：网页内容转Markdown笔记

看到一篇优质的技术博客，想保存为Markdown笔记？复制网页HTML源码，使用本工具一键转换为Markdown，方便导入到Notion、Obsidian、Typora等笔记软件中。

场景二：富文本编辑器内容导出

从富文本编辑器（如Word、微信公众号后台）复制的内容是HTML格式，转成Markdown后更易于版本管理和在GitHub、GitLab等平台发布。

场景三：文档迁移与重构

将旧版HTML文档批量转换为Markdown格式，便于用静态站点生成器（如Jekyll、Hugo、VuePress）重新构建文档站点。

Markdown语法速查表

# 一级标题
## 二级标题
### 三级标题

**加粗文本**
*斜体文本*
~~删除线~~

[链接文字](https://example.com "链接标题")
![图片描述](image.jpg "图片标题")

- 无序列表项1
- 无序列表项2

1. 有序列表项1
2. 有序列表项2

> 引用块

`行内代码`

```语言
代码块
```

| 列1 | 列2 | 列3 |
|-----|-----|-----|
| A   | B   | C   |

最佳实践与注意事项

• 对于复杂的HTML布局（如多层嵌套div），转换结果可能需要手动调整格式。
• 内联样式和CSS类无法在Markdown中表示，转换时会被忽略。
• 表格转换要求HTML表格结构规范（包含thead、tbody、tr、th、td等标签）。
• 所有转换在本地浏览器中执行，HTML内容不会上传到服务器，保障数据隐私。
• 转换大量HTML内容时，请分段转换以获得更好的结果。

HTML转Markdown与富文本编辑的关系

在富文本编辑器（WYSIWYG）中，用户看到的是格式化的文本，但其底层存储通常是HTML。当需要将富文本内容迁移到支持Markdown的平台（如GitHub、Notion、Obsidian、Hexo博客、VuePress文档站）时，HTML转Markdown是必不可少的环节。相比于手动重新排版，使用自动化转换工具可以节省90%以上的时间，同时减少手动操作可能引入的错误。

Markdown的流行生态

Markdown已经成为技术写作和内容创作的事实标准。GitHub、GitLab、BitBucket等代码托管平台原生支持Markdown格式的README和Issue；Stack Overflow、掘金、知乎等技术社区也支持Markdown编辑器；静态站点生成器如Jekyll、Hugo、Hexo、Gatsby、Next.js MDX都以Markdown作为内容源；笔记软件如Notion、Obsidian、Typora、Roam Research也都深度支持Markdown。掌握Markdown格式转换是内容创作者和开发者的必备技能。

转换质量的评估标准

一个优秀的HTML转Markdown工具应该具备以下特点：一是结构完整性，标题层级、列表嵌套、表格结构等能正确还原；二是语义准确性，链接、图片、引用等元素的属性不丢失；三是输出整洁性，转换后的Markdown格式规范、空行合理、没有多余的空白字符；四是容错能力，面对不规范的HTML输入也能给出合理的输出，而不是报错或产生乱码。