从其他系统迁移

把现有博客或 CMS 内容迁移到 Hugo 的工具。

简介

本节汇总一些与 Hugo 相关的独立开发项目。这些工具用于扩展功能，或者帮你更快上手。

如果你现在用的是 Jekyll、WordPress 一类的其他博客工具，但打算改用 Hugo，可以看看下面这份迁移工具清单。它们能帮你把内容导出成对 Hugo 友好的格式。

另一种做法是使用 Hugo 内置的 Jekyll 导入命令。

dokuwiki-to-hugo: 把 DokuWiki 源页面从 DokuWiki 语法迁移为 Hugo 的 Markdown 语法。它还包含 TODO 插件一类的额外处理。用 Python 3 编写，注重可扩展性。同时会为每个页面生成 TOML 头部。设计目标是让你把 wiki 目录直接复制粘贴进 content 目录。

wordpress-to-hugo-exporter: 一个一键式 WordPress 插件，把所有文章、页面、分类法、元数据与设置转换为 Markdown 和 YAML，可直接放进 Hugo。（注意：如果你在使用该插件时遇到问题，可以把站点导出为 Jekyll 格式，再使用前面提到的 Hugo 内置 Jekyll 转换器。）
blog2md: 适用于你的免费 YOUR-TLD.wordpress.com 网站导出的 xml 文件。它还会把已批准的评论连同文章一起保存到 YOUR-POST-NAME-comments.md 文件中。
wordhugopress: 一个用 Java 编写的小工具，从数据库中导出整个 WordPress 站点，以及存放在本地或远端的资源（例如图片）文件。因此也可以从备份文件进行迁移。支持把多个 WordPress 站点合并为一个 Hugo 站点。
wp2hugo: 一个基于 Go 的命令行工具，用于把 WordPress 网站迁移到 Hugo。它会保留原始 URL、GUID、图片 URL、代码高亮、目录以及 WordPress 导航分类。它可以迁移 WordPress 的自定义文章类型、自定义分类法、自定义字段与页面层级。它支持通过 Polylang 或 WPML 翻译的 WordPress 博客。它会导入 WordPress 媒体库数据库及其原始标题与日期。该工具可以下载全部媒体，也可以只下载插入到页面中的媒体。它会把 WordPress 短代码与 Gutenberg 区块转换为 Hugo 短代码，包括图库、图片、音频、YouTube 嵌入、Gist 与 Google Maps。

medium2md: 一个简单的 Medium 到 Hugo 的导出器，一条命令即可导入文章，包括前置字段。
medium-to-hugo: 一个用 Go 编写的命令行工具，把 Medium 文章导出为与 Hugo 兼容的 Markdown 格式。会包含标签与图片。所有图片都会下载到本地并正确链接。

tumblr-importr: 一个导入器，使用 Tumblr API 生成 Hugo 静态站点。
tumblr2hugomarkdown: 把所有 Tumblr 内容导出为 Hugo Markdown 文件，并保留原始格式。
Tumblr to Hugo: 一个迁移工具，把你的每篇 Tumblr 文章转换为带正确标题与路径的内容文件。它还会生成一个 CSV 文件，帮助你设置 URL 重定向。

hugojoomla: 这个用 Java 编写的工具读取 Joomla 数据库，把全部内容转换为 Markdown 文件。它会把 Joomla 内部格式的 URL 改为合适的形式。

blogimport: 把 Blogger 文章导入 Hugo 的工具。
blogger-to-hugo: 另一个把 Blogger 文章导入 Hugo 的工具。它还会下载内嵌图片，把它们保存到本地。
blog2md: 适用于你的 YOUR-TLD.blogspot.com 网站导出的 xml 文件。它还会把评论连同文章一起保存到 YOUR-POST-NAME-comments.md 文件中。
BloggerToHugo: 又一个把 Blogger 文章导入 Hugo 的工具。仅限 Windows 平台，且需要 .NET Framework 4.5。使用前请先阅读 README.md。
blogger2hugo: 把来自 Google Takeout 的 Blogger 备份文件（.atom）转换为 Markdown（.md）文件。该工具生成的输出与 Hugo 的 content/ 结构兼容。

BlogML2Hugo: 一个帮你把 BlogML xml 文件转换为 Hugo Markdown 文件的工具。附件与图片的链接需要用户自行处理。它能让导出 BlogML 文件的博客（例如 BlogEngine.NET）更容易转换为 Hugo 站点。