美观好用：Obsidian+Quartz+Cloudflare Pages快速博客发布指南

为得到更好的阅读体验，建议访问我的个人站 美观好用：Obsidian+Quartz+Cloudflare Pages快速博客发布指南 阅读

起源

学各种东西的过程中零零散散整理了不少文字，也有一些自己的想法，一直放在本地过段时间就再也想不起来在哪儿了，不如拿出来放在个人站上，还可以与他人讨论。

最开始考虑了Wordpress，但感觉许多配置都无法符合自己的预期，且难以更深度地自定义，于是转向寻找其他方案。考虑到本地的文档资料都是在Obsidian中使用Markdown整理的，因此最好寻找一个可以直接托管Markdown的工具框架，减少额外步骤。

兜兜转转比较了不少工具之后，最后落在了Quartz上。

Quartz

先来看看开发者自己对Quartz的定义：

Quartz is a fast, batteries-included static-site generator that transforms Markdown content into fully functional websites. Thousands of students, developers, and teachers are already using Quartz to publish personal notes, websites, and digital gardens to the web.

显然，这正是一个专为Markdown笔记转换为个人站点所制作的工具。如你所见，本站点就是使用Quartz搭建的。除了本站所示的一些功能外，它还有许多额外插件。

本文主要以介绍实际部署为主，对于其他功能与实现细节，可以访问 Quartz 官方站点 自行了解。

接下来，我将逐步介绍实际使用部署的方法。

环境要求

Quartz基于Node.js，对于Quartz v4.4.0，需要安装：

• Node.js ≥ v20，建议安装操作系统对应的v20.9.0版本。常用版本安装包已在下面直接列出：
  • Windows 64位：https://nodejs.org/dist/v20.9.0/node-v20.9.0-x64.msi
  • Windows 32位：https://nodejs.org/dist/v20.9.0/node-v20.9.0-x86.msi
  • MacOS ARM64（M系列）/X64（Intel）：https://nodejs.org/dist/v20.9.0/node-v20.9.0.pkg
• Git最新版本

安装完成后，进入系统自带终端，键入以下命令检查安装是否正确成功：

# 检查Node版本
node -v  # 输出：v20.9.0

# 检查Git安装是否成功
git -v   <