Quartz v5: статический сайт из Markdown

Quartz

Quartz — генератор статических сайтов из Markdown. Превращает Obsidian-совместимый контент в красивый сайт с графом, поиском, темами. Эта заметка — часть сайта на Quartz v5.

---

Установка

git clone https://github.com/jackyzha0/quartz.git my-garden
cd my-garden
npm install
npx quartz create   # интерактивная настройка

Все 44 плагина тянутся с github:quartz-community/*. Никаких vendor-патчей.

---

Сборка и деплой

npx quartz build     # → public/
rsync -avz --delete --chmod=F644 public/ user@server:/var/www/site/

--chmod=F644 обязателен

Caddy/nginx работают от своего пользователя и не смогут читать файлы с правами 600.

---

Frontmatter

---
title: Название страницы
description: Краткое описание
date created: 2026-07-13
date modified: 2026-07-13
tags:
  - topic
---

Три правила frontmatter

1. ---\n — обязательно с новой строки после ---
2. Никаких пустых строк между ключами
3. title — единственный заголовок страницы. Не дублируйте # Title в теле

Если frontmatter не парсится — все страницы показывают “Untitled”.

---

note-properties — НЕ отключать

Плагин note-properties тащит за собой remark-frontmatter — без него Quartz v5 вообще не парсит YAML frontmatter.

- source: github:quartz-community/note-properties
  enabled: true
  options:
    hidePropertiesView: true   # скрыть панель свойств

Если выключить note-properties

Все страницы станут “Untitled” — frontmatter не будет парситься.

---

Шрифты с кириллицей

Не все Google Fonts поддерживают кириллицу. Рабочие варианты:

Роль	Шрифт	Почему
Заголовки	Playfair Display	Серийный, элегантный, кириллица OK
Текст	Schibsted Grotesk	Гротеск, современный, кириллица OK
Код	JetBrains Mono	Уже с кириллицей

НЕ поддерживают кириллицу

DM Serif Display и Bricolage Grotesque (из оригинального jzhao).

---

Граф связей

Quartz строит D3 force-directed граф из wikilinks. На главной можно поставить свой граф через кастомный скрипт — quartz/static/hero-graph.js грузит contentIndex.json и рендерит SVG.

---

Wikilinks

[[index]]              # ссылка на content/slug.md
[[slug|Текст ссылки]]  # кастомный текст

Каждая заметка должна иметь wikilinks

Иначе узел изолирован в графе. Ссылайтесь с других страниц на новую.

---

Связанные статьи

• Docker — деплой через Docker
• Caddy — раздача статики через Caddy
• Syncthing — синхронизация сада между устройствами
• GitHub projects — vault на GitHub