一、背景
WordPress 是一个功能强大的内容管理系统,对于不会技术的人来说特别友好。对于只想写点文章的人来说,可能会显得过于笨重。页面加载慢、主题/插件管理复杂。如果你想要更简洁的工具,使用静态网页生成器可能是个好选择。
将 WordPress 文章导出为 Markdown 格式后,你就可以使用Hugo、Jekyll 或 Gatsby 轻量级生成器来发布博客。
二、准备
在 WordPress导出XML文件:登录 WordPress 后台,进入“工具” -> “导出”。导出所有内容,会得到一个 XML 文件。
三、转换
使用 wordpress-export-to-markdown 工具来将导出的 XML 文件转换为 Markdown 文件。具体的操作可以看看项目的说明。
(一)基本流程
- Wordpress导出xml
- 安装 nodejs
- npx 安装插件nodejs 插件 wordpress-export-to-markdown
- xml用插件转成markdown
(二)详细操作
-
首先需要安装 Node.js。这一步不多说了,下载安装就行了。要看你是否安装成功,打开命令行工具,输入 node -v 和 npm -v,能返回版本号即可。
-
将该项目下载到本地并解压(插件所在地址 github https://github.com/lonekorean/wordpress-export-to-markdown)。
-
为了方便起见,将 WordPress 导出的文件重命名为export.xml并将其放入运行该脚本的同一目录中(该工具查找的默认文件名)。
-
打开命令行工具,在工具所在的目录中,运行下面的命令
npx wordpress-export-to-markdown
脚本开始运行,会询问一些如何存储数据的问题。你自己根据情况回答。
? Path to WordPress export file? (export.xml) *要解析的文件名
? Path to output folder? (output) *保存的文件夹名
? Create year folders? (y/N) y *创建年份文件夹
? Create month folders? (y/N) N *创建月份文件夹
? Create a folder for each post? (Y/n) Y *每篇文章都创建文件夹
? Prefix post folders/files with date? (y/N) y *在文件/文件夹前加上日期
? Save images attached to posts? (Y/n) Y *保存文章的图片
? Save images scraped from post body content? (Y/n) Y *保存从帖子正文抓取的图像
回答完之后,脚本就开始解析 xml 文件并开始转换文章,同时下载图片。
对,默认就是在保存文件夹(out)下面按照年月日每篇文章创建文件夹。
四、其他方案
来自:【插件发布】WordPress 批量导出 Markdown | 虹线
在此前,网上比较成熟的方案是 Will Boyd 开发的[wordpress-export-to-markdown](https://github.com/lonekorean/wordpress-export-to-markdown),它能够较好的将 WordPress 博文转换成 Markdown 格式。但比较遗憾的一点是,它是一个 Python 程序,需要你在自己的电脑上配置 Python 环境,这对小白用户来说可能有一些难度。
我很惊讶于为什么在需求如此强烈的情况下,没有一个 WordPress 的插件可以在博客中直接完成这件事。刚好赶上字节跳动的类 Cursor IDE 工具处于免费推广期,可以无限次免费使用 Claude 3.7 Sonnet。于是,我就直接让 AI 帮我写了一个。从最初版本的生成,到 Debug 完成第一次发布,大概一共用了 6 个小时。
WP Markdown Exporter – 将你的 WordPress 全站批量导出为 MD 格式
当前版本:1.0.1 (2025 年 3 月 7 日)
本插件暂时没有上 WordPress.org 官方插件目录,所以更新可能有延迟