nexus/wiki/sources/building-your-quartz.md

title, type, tags, date

title	type	tags	date
Building your Quartz	source	clippings quartz obsidian	2026-04-17

Source File

• raw/Home Office/Building your Quartz.md

Summary（用中文描述）

• 核心主题：Quartz 静态网站构建与部署完整指南
• 问题域：如何将 Obsidian 笔记发布为可公网访问的静态网站
• 方法/机制：
  • 本地预览模式：npx quartz build --serve 启动热重载预览服务器
  • 自托管部署：通过 Nginx / Apache / Caddy 等主流 Web 服务器托管生成的 public/ 目录
  • 关键技术：利用 try_files 指令处理无扩展名 URL（Quartz 生成链接不含 .html 后缀）
• 结论/价值：Quartz 是一个将 Markdown 文件转换为静态网站的工具，生成的 public/ 目录可部署到任意静态托管平台，Serve 模式仅用于本地预览，生产部署需配置正确的 Web 服务器

Key Claims（用中文描述）

• Quartz 将 Markdown 文件和资源转换为 HTML、JS、CSS 静态文件（网站）
• 要发布网站到公网，需要使用托管服务，Quartz 生成的 public/ 目录可部署到任何支持静态 HTML 的服务
• 本地 Serve 模式仅用于预览，生产环境应使用专用托管方案
• 由于 Quartz 生成不含 .html 扩展名的链接，Web 服务器需配置 try_files 规则来处理 URL 重写
• 启用 RSS Feed 和 sitemap 功能需要正确配置 baseUrl

Key Quotes

"Quartz effectively turns your Markdown files and other resources into a bundle of HTML, JS, and CSS files (a website!)." — 核心功能描述 "Serve mode is intended for local previews only. For production workloads, see the page on hosting." — Serve 模式用途说明 "Since Quartz generates links that do not include the .html extension, you need to let your web server know how to deal with it." — 自托管关键配置说明

Key Concepts

• Static Site Generator：Quartz 的本质——将 Markdown 转换为静态 HTML/CSS/JS 网站的工具
• Obsidian Publishing：Quartz 作为 Obsidian 笔记发布平台的角色
• try_files Directive：Nginx/Caddy 中用于处理无扩展名 URL 的指令，Quartz 自托管必须配置

Key Entities

• Quartz：开源 Obsidian 发布工具，由 jzhao.xyz 维护
• Nginx：主流开源 Web 服务器，用于自托管 Quartz 生成的静态网站
• Apache：另一种主流 Web 服务器，支持 .htaccess 配置 URL 重写
• Caddy：现代开源 Web 服务器，默认支持 HTTPS，内置静态文件服务

Connections

• Obsidian ← uses ← Building your Quartz
• Static Site Generator ← implements ← Building your Quartz
• Obsidian Publishing ← extends ← Obsidian

Contradictions

• 无已知冲突内容