---
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 静态站点构建与自托管指南
- 问题域：静态站点生成与部署
- 方法/机制：通过命令行构建 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]]