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 静态站点构建与自托管指南
• 问题域：静态站点生成与部署
• 方法/机制：通过命令行构建 Quartz 静态站点，支持 Nginx、Apache、Caddy 三种自托管方案
• 结论/价值：Quartz 将 Obsidian 笔记转化为可托管的静态网站

Key Claims

• Quartz 将 Markdown 文件转化为 HTML、JS、CSS 静态文件
• 自托管需要配置 Web 服务器处理无 .html 扩展名的 URL
• 生产环境部署不应使用 --serve 模式

Key Quotes

"This will start a local web server to run your Quartz on your computer."

"Serve mode is intended for local previews only. For production workloads, see the page on hosting."

Key Concepts

• 静态站点生成：Quartz 将 Markdown 转换为静态 HTML 文件的技术
• 静态站点托管：通过 Web 服务器（Nginx/Apache/Caddy）托管静态文件
• Quartz：Obsidian 笔记静态站点生成器

Key Entities

• Obsidian：本地笔记软件，Quartz 的内容来源
• Nginx：高性能 Web 服务器，用于生产环境托管
• Apache：老牌 Web 服务器，用于自托管方案
• Caddy：自动 HTTPS 的现代 Web 服务器

Connections

• Obsidian →产出 静态站点生成 → Quartz
• 静态站点托管 ←依赖 Nginx
• 静态站点托管 ←依赖 Apache
• 静态站点托管 ←依赖 Caddy