如何将WordPress文章导出为Markdown文件并同步至Github

若要将某平台上的文章应用到其他场合，特别是要同步至其他网站，那么XML格式的转换至关重要。比如，当我发现某平台的文章排名较高，想要将其同步时，却发现没有现成的插件可用，只能通过导出XML文件并进行转换，这一过程中涉及诸多细节值得深入探讨。

一查看平台的导出功能

在平台的后台界面，得注意“工具”一栏中的“导出”功能。这一选项允许你挑选“全部内容”或特定内容进行导出，比如文章和页面等。若我有众多文章，我会选择导出全部内容。完成选择后，点击“下载导出的文件”即可获得XML格式的文件。然而，需留意，大文件可能会出现异常，比如我那300多篇文章，11MB、20多万行的文件就常常出现超时的情况。

导出功能是有的，但效果可能受文章数量影响。我曾尝试导至不同地方，文章较少时导出到Hugo插件顺利完成了，但换到其他地方就失败了，这很可能是因为我的文章数量过多。

二关于Node.js的安装

处理XML文件需借助特定的软件，而这软件又需Node.js的支持。首先，你得安装Node.js。只需访问官方网站，下载安装包并完成安装即可。那么，怎么检查安装是否成功？打开命令行，输入node-v和npm-v，若能显示版本信息，那就说明安装顺利。这是基础操作，若此步出错，后续步骤将无法进行。很多人就因为这一基础环节出了问题而受阻。

这只是一个初步的准备工作，很多人往往忽略了它的关键性，直到后续执行其他操作时出现错误，才意识到它的必要性。

三项目的本地下载与解压

将项目资料下载至本地并展开是关键步骤。需访问项目指定网站下载。下载成功后，获得压缩文件，必须将其解压，才能继续进行后续工作。若不解压，在命令行执行脚本时，将无法找到必要的文件和组件。

我之前忘了先解压，直接执行命令，结果出现了无法找到文件的奇怪错误。意识到自己的错误后，我重新解压，脚本这才顺利运行。这种错误挺常见，大家得特别小心。

四文件重命名与整理目录

将导出文件更名为工具预设的名称，便于后续操作，比如改成.xml格式。同时，需将文件置于执行脚本的同一文件夹中，以便工具能够识别并转换该文件。若文件位置不正确，脚本执行时将提示找不到文件。

由于我没仔细阅读工具的说明，错误地放置了工具，这让我浪费了大量时间来查找错误。最终，我发现问题仅仅出在这个小步骤上。这个经验教训大家一定要记牢。

五运行转换脚本

npx wordpress-export-to-markdown

在命令行操作中，先找到工具存放的文件夹，然后执行相应的指令。启动后，脚本会询问有关存储数据的几个问题，只需根据实际情况逐一作答即可。回答完毕，脚本便着手处理XML文档，并且会同步下载文章里的图片，无需担心图片会丢失。

? 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 *保存从帖子正文抓取的图像

若网络状况不佳或电脑性能较低，系统运行速度可能会变慢，这时得有耐心等待。比如，我曾在较旧的电脑上进行转换，耗时较长。

六转换后的处理和后续问题

文件转换完成，每篇文章的目录下都会有对应的子文件夹和index.md文件。打开这些文件，可以直接在VSCode中查看。使用这些转换后的文件，操作起来十分方便，可以轻松上传到其他静态网站构建工具，亦或用于AI训练等用途。

使用这个脚本确实有困扰，比如我编写的机场票价简码，脚本只能识别这些简码，后续处理还得另寻他法。目前，我打算同步新文章，却还没找到合适的解决方案。大家有没有遇到过类似的情况？期待在评论区看到大家的分享，也请大家点赞并转发这篇文章。

继续浏览有关 WordPress静态网页生成器命令行工具下载解决方案 的文章