哪些 HTML 能直接变成 Markdown

语义清楚的 HTML 最容易转换。h1–h6 对应标题，p 对应段落，strong 与 em 对应强调，a 对应链接，ul/ol/li 对应列表。div 和 span 通常只负责布局或样式，标签本身可以删除，但其中的文字要保留。

转换前尽量取得源码或 CMS 的正文 HTML。只复制浏览器中看见的文字，链接地址和结构可能已经丢失；直接转换整页源码，又会把导航、页脚、推荐位和追踪代码带进来。

  • h1–h6 → Markdown 标题
  • strong、em → 粗体与斜体
  • a href → Markdown 链接
  • ul、ol、li → 无序和有序列表
  • blockquote → 引用
  • pre、code → 代码块或行内代码
  • 简单 table → Markdown 表格
HTML 输入
<h2>发布记录</h2>
<p>阅读<a href="/guide">指南</a>。</p>
<ul><li>导出更快</li><li>表格更清楚</li></ul>
Markdown 输出
## 发布记录

阅读[指南](/guide)。

- 导出更快
- 表格更清楚

在线转换 HTML 为 Markdown 的步骤

保留源 HTML 和转换结果的可编辑能力很重要。转换器可能无法替你判断某个容器是正文还是广告，但你可以在结果中删除。

  1. 加入 HTML粘贴正文源码、打开 .html 文件，或从 CMS 源码视图复制相关片段。
  2. 检查 Markdown 结构查看标题、链接、嵌套列表、图片、表格和代码块。
  3. 删除页面杂项清理菜单、面包屑、分享按钮文字、推荐文章和重复页脚。
  4. 复制或下载在渲染预览中通读后，复制到仓库、文档站或笔记应用。

CMS 迁移前先把正文与旧主题分开

旧站 HTML 可能混有大量主题类名和内联样式。新系统通常不需要这些展示细节。先转换文章正文，再统一标题层级、链接和图片地址，迁移会更稳。

不要把菜单中的“首页、产品、关于我们”误当成文章列表。转换后从读者角度通读，凡是离开原页面就失去意义的导航文字、弹窗提示和推广模块，都应删除或改写。

  • 只选择 article/main 区域或 CMS 正文
  • 去掉重复站点导航和页脚
  • 统一一篇文章内的 H1/H2/H3
  • 检查外链与站内相对链接
  • 在关闭旧站前保存原图片或明确新地址

相对链接和图片路径为什么会失效

`/guide` 在旧站表示“旧域名下的 guide 页面”。Markdown 搬到另一个域名、GitHub 仓库或本地笔记后，这个地址可能指向完全不同的位置。相对图片路径同样依赖原页面目录。

迁移前列出站内链接和图片来源：需要继续指向旧站的改成完整 URL；迁移到新站的按新路由重写；本地图片与 Markdown 一起搬动并保持目录关系。

原地址潜在问题处理方式
/about依赖原域名确认是保留旧站还是改成新站完整地址
../images/a.png依赖原文件目录移动图片并更新相对路径
https://cdn.example.com/a.png资源可能过期或限制访问确认长期可用性和使用权限
#section依赖标题生成的锚点检查新渲染器生成的 ID

复杂表格为什么不能无损变成 Markdown

Markdown 表格只有规则的行和列，不支持 HTML 的 rowspan、colspan、单元格内复杂块、表头分组等能力。强行转换会让数据错位，比保留 HTML 更危险。

对于简单表格，可以生成 Markdown 竖线语法。遇到合并单元格时，更诚实的做法是保留经过安全处理的 HTML 表格，或者人工重构为几张简单表、标题与列表。

  • 规则行列表格 → Markdown 表格
  • 合并单元格 → 保留安全 HTML 或人工拆分
  • 用于计算的大表 → 另提供 CSV/XLSX
  • 移动端阅读 → 减少列数，避免横向溢出

多列、标签页、表单和嵌入组件如何处理

Markdown 故意没有完整网页布局能力。多列布局通常应按阅读顺序变成几个章节；标签页和折叠面板要展开成清楚的小标题；表单只保留说明文字，不能假装仍可提交；视频和嵌入组件应改成链接或目标平台支持的语法。

转换器可以提取文字，却不知道交互背后的业务逻辑。迁移这类内容时，先记录原功能，再决定在新平台中重新实现、改成静态说明，还是删除。

把转换结果当成文章读一遍

语法有效不等于内容好用。转换结果可能仍含“点击右上角”“见下方模块”等依赖旧页面的文字，也可能有多个 H1、模糊链接和重复小标题。

用渲染预览从头读到尾：标题是否描述内容，列表是否保持层级，链接文字是否独立可理解，图片是否有替代文字，代码块是否闭合。这个编辑步骤才是把抓取的 HTML 变成可维护 Markdown 的关键。

转换并编辑 HTML原始 HTML 与 Markdown 结果都可修改整理 Markdown 格式统一空行和常见标记写法查看渲染结果按读者视角检查结构

HTML 转 Markdown 迁移检查清单

关闭旧页面前，至少确认以下事项。

  • 文章标题和章节层级完整
  • 站内外链接指向正确环境
  • 图片已迁移并可访问
  • 导航、页脚和推广杂项已删除
  • 简单表格没有错列，复杂表格有明确处理
  • 代码和引用没有被并入普通段落
  • 新页面在桌面和手机上都能阅读
  • 保留一份原 HTML 作为迁移记录

相关工具

Markdown 转 HTML把清理后的源文档重新用于网页Markdown 格式化统一迁移结果的空行和标记风格Markdown 语法速查核对表格、代码和转义
FAQ

常见问题

HTML 的 CSS 样式会转换成 Markdown 吗？

通常不会。Markdown 主要保留内容结构，颜色、间距、多列和装饰性容器会被删除。

HTML 表格能转成 Markdown 表格吗？

简单行列表格可以。带合并单元格、嵌套块或复杂表头的表格应人工简化或保留安全 HTML。

应该粘贴网页文字还是 HTML 源码？

使用相关正文的 HTML 源码。只粘贴可见文字会丢链接和结构，整页源码又可能带入菜单和页脚。

转换后能再变回完全相同的网页吗？

不能保证。Markdown 保留正文语义，不保存旧主题的 CSS、布局、脚本和交互组件。