将WordPress导出转换为Markdown的利器

2026-01-15 16:36:48作者：咎岭娴Homer

在数字化内容创作的世界中，越来越多的人选择使用静态站点生成器来托管他们的博客和网站，如Gatsby、Hugo和Jekyll等。但如何将现有的WordPress内容顺利迁移到这些平台？这就引出了我们的主角——wordpress-export-to-markdown。

这是一个强大的脚本，能将WordPress的XML导出文件直接转化为适合静态站点生成器的Markdown文件。不仅如此，它还能保留所有的图像，并处理嵌入的内容，如YouTube视频、Twitter推文或CodePen代码片段，使迁移过程变得简单快捷。

快速上手

要开始使用这个工具，你只需要：

安装Node.js v12.14或更高版本。
获取你的WordPress导出文件（确保选择了“全部内容”以保存图片和/或页面）。

然后，在命令行里，你可以通过以下方式运行：

npx wordpress-export-to-markdown

或者克隆项目后再运行（这样重复运行更快，还可以自定义代码）。克隆后在终端转到包目录并执行：

npm install && node index.js

无论是哪种方式，它都会启动一个向导，引导你完成设置。

命令行选项

如果想在命令行中设置选项，你可以这样做：

npx wordpress-export-to-markdown --post-folders=false --prefix-date=true

或者在本地克隆的副本中运行：

node index.js --post-folders=false --prefix-date=true

向导会询问未指定的选项，如果你想完全跳过向导并使用默认值，可以添加--wizard=false。

可选参数

使用向导？（--wizard）
- 类型：布尔型
- 默认：true
- 启用后，脚本会提示你每个选项。禁用则直接使用默认值。
WordPress导出文件路径？（--input）
- 类型：文件路径
- 默认：export.xml
- 指定WordPress导出文件的位置。
输出文件夹路径？（--output）
- 类型：文件夹路径
- 默认：output
- 指定Markdown和图片文件的保存位置。若不存在，将为你创建。
创建年份文件夹？（--year-folders）
- 类型：布尔型
- 默认：false
- 是否按年份组织输出文件。
创建月份文件夹？（--month-folders）
- 类型：布尔型
- 默认：false
- 是否按月份组织输出文件。通常与--year-folders结合使用。
为每篇文章创建文件夹？（--post-folders）
- 类型：布尔型
- 默认：true
- 设置是否以帖子的slug为名创建文件夹，以及Markdown文件名为index.md。
在帖子文件名前加上日期？（--prefix-date）
- 类型：布尔型
- 默认：false
- 是否在帖子slug前加上发布日期。
保存附加到帖子的图片？（--save-attached-images）
- 类型：布尔型
- 默认：true
- 是否下载并保存与帖子关联的图片。
保存从文章内容中抓取的图片？（--save-scraped-images）
- 类型：布尔型
- 默认：true
- 是否下载并保存从<img>标签中提取的图片。
包括自定义类型和页面？（--include-other-types）
- 类型：布尔型
- 默认：false
- 如果设为true，将包含自定义类型和其他类型的帖子。