HTML转Markdown转换器

哪些 HTML 结构会变成 Markdown

<h2>安装</h2> 会得到 ## 安装，<strong>重点</strong> 会得到 **重点**。转换页面面向短小、结构清楚的 HTML 片段，输入后立即生成 Markdown，可复制或下载为 converted.md。

HTML 输入	Markdown 输出
h1 至 h6	1 至 6 个 # 的 ATX 标题
b、strong	**粗体**
i、em	*斜体*
a href	[文字](地址)
img src/alt	；无法识别替代文字时输出空 alt
pre > code、code	围栏代码块、行内代码
blockquote、hr、br、p	引用、水平线、换行和段落空行

常见实体  、<、>、&、" 和 ' 会还原为字符。其他未识别标签会被移除，但标签内的文本通常仍会留下。

这是结构映射，不是网页复刻

HTML 可以表达样式、脚本、表格、复杂嵌套和任意属性；基础 Markdown 只覆盖一部分文档语义。当前转换不会读取网页地址，也没有上传 HTML 文件的入口，更不会把 CSS 布局、字体、颜色或交互行为翻译成 Markdown。它适合迁移正文骨架，不适合还原整页视觉效果。

列表需要特别留意：ul 与 ol 外层会被移除，所有 li 都输出为连字符项目，因此原本的有序列表会失去编号。嵌套列表、列表内多段内容和深层嵌套标签也可能被压平。

从粘贴到下载的工作流

1. 准备正文片段

   先保留标题、段落、强调、链接、图片和简单列表，删除与正文无关的导航、样式及脚本内容。输入区接受直接键入，也可调用浏览器剪贴板粘贴。

2. 观察同步输出

   输入变化后，右侧会显示 Markdown 源文本。需要快速试用时，可加载页面自带的标题、段落、链接和列表示例。

3. 逐项检查语义

   重点检查有序列表、图片替代文字、代码中的尖括号、连续段落和嵌套标签。原 HTML 含表格时，应在转换后另行重建 Markdown 表格。

4. 复制或保存

   使用复制按钮把完整结果放入剪贴板，或下载 converted.md。粘贴到目标编辑器后再预览一次，因为不同平台支持的 Markdown 扩展并不相同。

一段可核对的转换示例

<h1>发布说明</h1>
<p>阅读<strong>变更列表</strong>，访问<a href="https://example.com/docs">文档</a>。</p>
<ul><li>修复登录</li><li>更新帮助</li></ul>

对应结果为：

# 发布说明
阅读**变更列表**，访问[文档](https://example.com/docs)。

- 修复登录
- 更新帮助

示例中的空行来自段落结束；列表项统一使用 -。如果把 ul 换成 ol，当前结果仍是连字符列表，这正是需要人工复核的差异。

转换结果为什么需要复核

HTML 表格会自动变成 Markdown 表格吗？

不会。表格标签会被移除，单元格文字可能直接相连。需要保留行列关系时，请先用简单表格样例试转换，并在结果中手动补写竖线和表头分隔行。

为什么有序列表变成了无序列表？

当前所有 li 都映射为 - 项目，不区分外层是 ol 还是 ul。编号包含业务含义时，应在导出后恢复为 1.、2. 等。

图片为什么没有替代文字？

图片必须含可识别的 src，且常见的 src 后接 alt 顺序最稳妥。属性顺序或写法不匹配时，结果仍可能保留图片地址，但生成空的替代文字。

能直接粘贴完整网页源码吗？

可以输入文本，但不建议把未经清理的整页源码当作无损转换。导航、表单、表格、样式与脚本不属于当前可靠映射范围，残留文本可能混入正文。

兼容性与内容安全边界

转换结果是可编辑草稿，不保证符合 GitHub Flavored Markdown、某个博客系统或笔记软件的全部扩展语法。发布前应在目标平台预览并核对链接、图片与代码。

• 复杂嵌套采用简化匹配；同一行多层标签、跨行内联标签或格式不规范的 HTML 可能丢失标记或顺序。
• 样式和脚本标签本身不会保留，但其内部文本可能留下。不要把未经审查的输出直接发布，也不要把转换当作 HTML 安全清洗或恶意代码检测。
• 链接地址和图片地址按输入写入结果，不验证目标是否可信、可访问或适合公开。
• 代码块只识别紧邻的 pre 与 code 形式；实体还原范围有限，含其他命名实体或数字实体的内容可能保持原样。
• 从 Markdown 转回 HTML 属于页面上的另一个方向入口；两个方向都不是严格可逆，往返转换可能继续损失结构。