Свой vault на GitHub

У тебя уже есть vault с заметками (в Obsidian или просто папка с .md)? Тогда путь такой: создаёшь репозиторий → кладёшь в него vault → подключаешь сборку. Терминал не обязателен.

Сначала реши, что публикуешь

На сайт попадёт всё содержимое vault'а (режим по умолчанию). Если в заметках есть личное — либо скопируй в репозиторий только нужную папку, либо включи режим public (шаг 4): публикуются только заметки, помеченные publish: public.

Шаг 1 — создай репозиторий

  1. Открой github.com/new.
  2. Придумай имя (оно станет адресом: ник.github.io/имя).
  3. Выбери Public (бесплатный GitHub Pages работает только с публичными репозиториями; если репозиторий нужен приватный — публикуй через Netlify или Vercel, они собирают приватные бесплатно).
  4. Create repository.

Шаг 2 — загрузи vault

Без git, прямо в браузере:

  1. В новом репозитории нажми uploading an existing file.
  2. Перетащи папку своего vault'а в окно загрузки (браузер умеет принимать папки целиком).
  3. Commit changes.
Большой vault?

Веб-загрузка принимает до ~100 файлов за раз. Если заметок больше — перетаскивай папками по частям, либо поставь GitHub Desktop (графический клиент, без терминала): File → Add local repository → Publish.

Рекомендация: складывай заметки в папку vault/ внутри репозитория (а не в корень) — так конфиги сборки не смешиваются с заметками.

Шаг 3 — подключи сборку

  1. В репозитории: Add file → Create new file.
  2. В поле имени введи: .github/workflows/publish.yml (слэши создадут папки).
  3. Вставь содержимое publish.yml из шаблона — он сам подставит твой ник и имя репозитория. Если заметки лежат не в vault/, поменяй строку vault-dir: vault (для корня — vault-dir: .).
  4. Commit changes.
  5. Включи Pages: Settings → Pages → Source: GitHub Actions.
  6. Вкладка Actions → workflow «Publish site» → Run workflow.

Через ~2 минуты сайт живёт на ник.github.io/имя-репозитория. Дальше — Как обновлять сайт.

Шаг 4 — настрой под себя

Создай в корне репозитория файл markdown-publish.config.json:

{
  "siteName": "Мои заметки",
  "siteLang": "ru",
  "vaultDir": "vault",
  "buildMode": "full"
}
  • buildMode: "public" — публиковать только заметки с publish: public во frontmatter (остальные не попадут ни на сайт, ни в поиск, ни в граф).
  • Остальные ключи: Конфигурация.
Хочется ещё проще?

Если готового vault'а нет или хочется сначала пощупать — начни с шаблона в пару кликов, а заметки перенесёшь потом.