如何将 HTML 转换为 Markdown 风格文本

适用场景与转换范围

这款工具用于把一段 HTML 片段整理成 Markdown 风格文本，适合在迁移文章、整理文档或准备 Markdown 内容时使用。它会处理部分标题、链接、图片、强调、代码、列表、引用和段落结构，也会移除符合规则的脚本与样式块。由于转换依赖支持的标签、属性和结构，使用前应先确认原始 HTML 的写法。

操作步骤：将 HTML 转成 Markdown

1. 准备需要转换的 HTML 片段，尽量保留清晰的标签结构。输入框可以不填写；省略输入或提交空内容时，操作会成功完成并返回空的转换文本。
2. 将 HTML 粘贴到输入区域，然后执行转换。标题会按一级到六级映射为 Markdown 标题前缀；符合条件的链接和图片会转换为 Markdown 链接与图片语法，图片的替代文本取决于匹配到的属性顺序和写法。
3. 检查转换结果。没有属性的 strong、b、em 和 i 元素可转换为 Markdown 强调标记；符合准确结构的 pre 与 code 组合会成为围栏代码块，匹配的裸 code 元素会成为行内代码。部分列表、引用、段落、换行、分隔线和常见块级容器也会获得相应的 Markdown 风格处理。
4. 对照原文复核未转换部分，尤其是带属性的强调标签、属性或嵌套结构不同的元素。处理完成后，符合移除规则的剩余标签语法会被删除，但标签中的非标签文本会保留。最后，连续四个或更多换行会压缩为三个，结果开头和结尾的空白会被去除。

如何检查转换结果

结果应理解为经过指定文本转换后的 Markdown 风格文本，而不是对所有 HTML 变体都适用的完整解析结果。标题、链接、图片、部分内联格式和特定代码结构可能已经变成 Markdown；不符合匹配条件的属性或嵌套写法可能不会按预期转换，后续的标签移除也可能只留下其中的文本。

实体处理同样有范围：工具会解码定义的一组命名实体和十进制数字字符引用。格式不是 &#数字; 的异常数字引用可能保持不变；仅由数字组成但超出字符转换有效范围的引用可能导致转换失败。因此，发布前应检查链接地址、图片替代文本、代码块、实体和被保留的文字。

使用示例

你有一段包含二级标题和段落的文章片段，希望在整理 Markdown 文档前先查看其转换后的文本形态。

将这段 HTML 片段粘贴到输入区域并执行转换，然后对照输出检查标题和段落。

结果应呈现 Markdown 风格文本，例如标题显示为 Markdown 标题前缀，段落文字保留；随后检查是否还有未预期的标签语法。

使用限制

• 转换范围受支持的标签、属性和结构限制，不应视为完整的 HTML 解析；部分异常十进制字符引用可能保持不变或导致转换失败。

常见错误

• 如果带属性的标签或代码结构与支持的形式不同，结果可能保留部分标签或缺少预期格式。请先改用结构清晰、属性写法符合要求的 HTML，再重新转换，并逐项检查链接、图片和代码内容。

常见问题

它能把所有 HTML 都准确转换成 Markdown 吗？

可以，但结果取决于标签、属性和嵌套结构是否符合支持的转换形式。标题、部分链接、图片、强调、代码、列表和引用可获得 Markdown 风格处理，其他变体需要复核。

不输入内容也能执行吗？

可以。输入省略或为空时，操作会成功完成，并返回空的转换文本。

HTML 实体会被转换吗？

不一定。符合 &#数字; 形式的十进制数字字符引用会进入字符转换；格式异常的引用可能保持不变，超出有效范围的数字引用可能导致转换失败。