---
title: "Building your Quartz"
type: source
tags:
  - clippings
  - quartz
  - obsidian
date: 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
- 无已知冲突内容