UltKit

HTML转Markdown转换器

HTML是内容的发布形式,而越来越多的人更喜欢用Markdown来写作和保存内容。这款转换器把.html文件转换成易读的.md文本,让博客存档、帮助中心或保存的文章可以迁移到静态网站、笔记库或Git仓库中。

文档转换器

或将PDF, DOC, DOCX … 文件拖放到此处 ·

单个文件最大 95 MB· 最多 20 个文件· 30 分钟后删除

输出

文件在我们的服务器上处理,并在 30 分钟后删除。

使用方法

  1. 1

    上传HTML文件

    添加 .html 或 .htm 文件,每批最多 20 个,每个不超过 95 MB。浏览器保存的网页、CMS 导出的文件或手写的文件都可以。

  2. 2

    检查文本设置

    转换为选 Markdown,格式选简化,文本编码选 UTF-8,换行符选 LF,适合 Git、静态网站生成器以及 macOS 或 Linux 编辑器。

  3. 3

    转换为Markdown

    点击转换为 Markdown,然后用任意文本编辑器打开 .md 文件,删除残留的菜单或页脚。上传的文件会在 30 分钟后删除。

要把 HTML 转为 Markdown,上传 .html 文件并点击转换为 Markdown:标题变成 # 开头的行,链接变成 文字,列表保留项目符号和编号,简单表格变成竖线表格。

HTML转Markdown:谁需要、为什么需要

2004 年,John Gruber 与合作者 Aaron Swartz 发布了 Markdown,让人们用纯文本为网页写作,即使未经渲染也读起来自然。二十年后,它已成为 GitHub README、Jekyll 和 Hugo 等静态网站生成器、文档工具、Obsidian 等笔记应用以及许多现代网站内容目录的原生格式。

这带来了一股与通常方向相反的稳定需求。离开数据库驱动 CMS 的团队需要把多年的文章变成 .md 文件。写作者把文章剪藏到笔记库。开发者把旧的 HTML 帮助栏目迁入“文档即代码”仓库,在 pull request 中审阅改动。这些情况下,HTML 往往是唯一的副本,手动重写并不现实。如果来源是 Word 文档,对应的是 DOCX转Markdown。

哪些HTML元素有对应的Markdown写法

from ↓ · to →CommonMarkGitHub Flavored Markdown
h1–h6 标题h1–h6 标题 to CommonMark: yesh1–h6 标题 to GitHub Flavored Markdown: yes
链接和图片链接和图片 to CommonMark: yes链接和图片 to GitHub Flavored Markdown: yes
列表和引用块列表和引用块 to CommonMark: yes列表和引用块 to GitHub Flavored Markdown: yes
code 和 pre 代码块code 和 pre 代码块 to CommonMark: yescode 和 pre 代码块 to GitHub Flavored Markdown: yes
简单表格– 简单表格 to CommonMark: no简单表格 to GitHub Flavored Markdown: yes
删除线– 删除线 to CommonMark: no删除线 to GitHub Flavored Markdown: yes
合并的表格单元格– 合并的表格单元格 to CommonMark: no– 合并的表格单元格 to GitHub Flavored Markdown: no
表单、视频、iframe– 表单、视频、iframe to CommonMark: no– 表单、视频、iframe to GitHub Flavored Markdown: no
supported not offeredCommonMark 自 2014 年起制定,是严格的核心规范;GitHub Flavored Markdown 于 2017 年制定,增加了表格、删除线和任务列表。任何没有 Markdown 写法的内容都可以保留为原始 HTML,两者都允许这样做。

HTML转Markdown的输出效果

类名、内联样式、脚本和布局用的 div 都会被丢弃,因为 Markdown 描述的是含义,而不是外观。粗体和斜体分别变成双星号和单星号,段落内的换行会被合并,  等字符实体会变成 UTF-8 中的普通字符。.md 文件的大小通常只有 HTML 的一小部分:文字保留,标记去掉。

误区Markdown 可以还原任何 HTML 版式。

事实它只涵盖文本结构;分栏、颜色和定位的盒子没有对应的 Markdown 语法,会丢失或保留为原始 HTML。

误区转换后的页面可以直接发布。

事实菜单、Cookie 横幅和页脚也会一并转换;请先删减,并在网站生成器需要时添加 front matter。

误区Markdown 输出在任何地方效果都一样。

事实表格和删除线需要支持 GitHub Flavored Markdown 的渲染器;严格的 CommonMark 工具会把它们显示为纯文本。

HTML与Markdown格式要点

HTML

超文本标记语言

HTML 是网页的标记语言,由 Tim Berners-Lee 在 20 世纪 90 年代初提出,现由 WHATWG 作为活标准维护。HTML 文件描述标题、段落、链接、表格、图片和表单,样式通常由 CSS 提供。所有浏览器都能渲染它,它也用于邮件模板和保存的网页。单个 HTML 文件往往依赖外部图片和样式表,单独移动后可能显示异常。

压缩方式
–
透明度
–
动画
–
发布年份
1993 · Tim Berners-Lee; maintained by WHATWG
HTML 转换器

MD

Markdown

Markdown 是 John Gruber 于 2004 年创建的轻量级标记语法。它使用纯文本符号,例如用 # 表示标题、用 * 表示强调、用 - 表示列表,这些符号在原始文本中依然易读,也能干净地转换为 HTML。它是 README 文件、文档、维基、笔记应用和许多静态网站生成器的标准。它有多种方言,例如 CommonMark 和 GitHub Flavored Markdown,在表格等细节上有所不同。任何文本编辑器都能打开 .md 文件。

压缩方式
–
透明度
–
动画
–
发布年份
2004 · John Gruber
MD 转换器

当内容离开原来的渲染环境时,就需要把 HTML 转为 Markdown:博客迁移到静态网站生成器,帮助中心转入基于 Git 的文档仓库,或把文章存入 Obsidian 库,这些场景中简洁易读的纯文本比标记更重要。

HTML转MD常见问题

能把保存的网页连同图片一起转换吗?

转换器读取的是你上传的 .html 文件。图片标签会变成 Markdown 图片链接,指向页面原来使用的路径或网址,因此在线托管的图片仍可正常显示。浏览器“另存为”生成的本地图片文件夹不会随文件一起上传;把它复制到 .md 文件旁边,相对路径依然匹配。

菜单、侧边栏和页脚会怎样处理?

文件中的所有内容都会被转换,因为工具无法判断页面中哪部分是正文。想要干净的结果,可以在 CMS 允许时保存不带主题的文章,或者事后删除 Markdown 顶部和底部的导航行。

如何把WordPress文章迁移到Hugo或Jekyll?

WordPress 内置的导出文件是 XML,不是 HTML,所以请改为转换每篇文章的 HTML,可从代码编辑器复制,或从浏览器保存。然后在每个 .md 文件顶部添加 front matter,即两行三个短横线之间的区块,用来存放标题、日期和标签。Hugo 和 Jekyll 都会从这里读取。

为什么有些表格在Markdown中显示异常?

Markdown 表格由 GitHub Flavored Markdown 引入,只有一行表头,不支持合并单元格。简单的 HTML 表格可以顺利转换;带有 colspan、rowspan 或嵌套列表的表格没有对应的 Markdown 写法,会被展平。Markdown 允许使用原始 HTML,所以在需要保留版式的地方可以把原表格粘贴回去。

Markdown适合用来把网页提供给AI或搜索工具吗?

通常是的。Markdown 保留标题、列表、链接和强调等重要结构,同时去掉属性、脚本和样式,所以同一篇文章会短得多,也更便于处理。如果完全不想要标记,请使用 HTML转TXT。