WordPress全站文章导出为Markdown

一、wordpress-export-to-markdown

优点：

• 一篇文章一个 .md 文件
• 自动带 YAML frontmatter（标题、日期、分类、标签、作者）
• 自动下载所有文章图片并修正链接
• 可按年 / 月 / 文章分文件夹
• 免费开源、跨平台（Windows/macOS/Linux）

1. 先从 WordPress 导出 XML

1. 后台 → 工具 → 导出
2. 选择：全部内容（文章、页面、媒体、评论）
3. 下载得到：WordPress.XXXX-XX-XX.xml

2. 安装 Node.js（必须）

• Windows/macOS：https://nodejs.org/ 安装 LTS 版
• 安装后打开 终端 / PowerShell / CMD，检查：

 node -v
 npm -v

3. 一行命令转换（最简单）

把你下载的 .xml 改名为 export.xml，放在一个空文件夹里。

在该文件夹打开终端，运行：

 npx wordpress-export-to-markdown

然后按向导回答：

• Path to WordPress export file? → 直接回车（默认 export.xml）
• Output folder? → 直接回车（默认 output）
• Create year/month folders? → y/n（建议 y）
• Create folders for each post? → y/n
• Download images? → y（必须选 y 才会下图片）

等待完成 → 会在 output/ 下生成所有 .md + 图片文件夹。

4. 生成结果示例

 output/
 ├── 2024/
 │   ├── 01/
 │   │   ├── my-first-post/
 │   │   │   ├── index.md
 │   │   │   └── images/
 │   │   │       ├── pic1.jpg
 │   │   │       └── pic2.png
 │   │   └── another-post.md
 │   └── 02/
 └── 2025/

每个 .md 开头会自带 frontmatter（可直接用于 Hugo/VuePress/Obsidian）：

 ---
 title: 文章标题
 date: 2024-01-01
 categories: 分类
 tags: 标签, 技术
 author: 你的名字
 ---
 正文内容……