cnblog2md v1.9.0

cnblog2md

解析博客园备份 xml 文件，生成 markdown 和对应图片文件，并将文件保存到本地的命令行工具

安装

全局安装

npm i -g cnblog2md

cnb -v

局部安装

npm i cnblog2md -D

npx cnb -v

输出版本号即安装成功

使用示例

使用前需要准备好博客的备份文件，可以到 这里 去下载本分文件

为了减少对网站性能的影响，麻烦您在工作日18:00之后、8点之前或周六、周日进行备份。

⚠️ 需要注意的是，博客园备份功能开放时间是： 周一到周五 18:00-08:00 周六日全天

假设我们准备好了备份文件 CNBlogs_BlogBackup.xml ，运行以下命令

cnb -f CNBlogs_BlogBackup.xml -m mds -i imgs

解析完会在运行目录生成 mds 和 imgs 文件夹

如果不使用 -m 和 -i 来自定义存储文件夹，则所有文件默认存放到运行目录

参数

自定义目录

可通过自定义设置保存目录来进行文件的保存，工具提供了日期时间模板的解析，使用时只需用 {{}} 包裹即可

常用格式化占位符如下，具体可参考 dayjs

目录使用日期时间

有时候需要根据文章的发布日期来进行生成目录，如 mds/2022/xxx.md 或者 imgs/2022/10/24/xxxx.png

此时，只需要在命令行输入

cnb -f CNBlogs_BlogBackup.xml -m mds/{{YYYY}} -i imgs/{{YYYY}}/{{MM}}/{{DD}}

Markdown 图片自定义路径

如果要自定义 markdown 文件内图片的路径，如 ![](/public/xxxx.png)

则可以

cnb -f CNBlogs_BlogBackup.xml -mi /public

自定义输出文章格式

输入 markdown 文件时，通常我们需要自定义一些头部信息，工具默认输出文章格式如下

---
title:  文章标题
author: 作者
date: 文章发布时间
isPublished: 是否发布
categories:
  - 分组一
tags:
  - 标签一
  - 标签二
---

#  文章标题

文章内容

默认模版

如需自定义输入格式，可在运行目录新增 cnb-template.hbs 或者 cnb-template.handlebars 文件

默认解析模板如下，可根据需求进行更改，具体模版语法可查看 handlebars

---
title: {{safeTitle}}
author: {{author}}
date: {{date}}
isPublished: {{isPublished}}
categories:
{{#each categories}}
  - {{this}}
{{/each}}
tags:
{{#each tags}}
  - {{this}}
{{/each}}
---

# {{title}}

{{content}}

可用模版变量

License

MIT