Свой vault на GitHub
У тебя уже есть vault с заметками (в Obsidian или просто папка с .md)? Тогда путь такой: создаёшь репозиторий → кладёшь в него vault → подключаешь сборку. Терминал не обязателен.
На сайт попадёт всё содержимое vault'а (режим по умолчанию). Если в заметках есть личное — либо скопируй в репозиторий только нужную папку, либо включи режим public (шаг 4): публикуются только заметки, помеченные publish: public.
Шаг 1 — создай репозиторий
- Открой github.com/new.
- Придумай имя (оно станет адресом:
ник.github.io/имя). - Выбери Public (бесплатный GitHub Pages работает только с публичными репозиториями; если репозиторий нужен приватный — публикуй через Netlify или Vercel, они собирают приватные бесплатно).
- Create repository.
Шаг 2 — загрузи vault
Без git, прямо в браузере:
- В новом репозитории нажми uploading an existing file.
- Перетащи папку своего vault'а в окно загрузки (браузер умеет принимать папки целиком).
- Commit changes.
Веб-загрузка принимает до ~100 файлов за раз. Если заметок больше — перетаскивай папками по частям, либо поставь GitHub Desktop (графический клиент, без терминала): File → Add local repository → Publish.
Рекомендация: складывай заметки в папку vault/ внутри репозитория (а не в корень) — так конфиги сборки не смешиваются с заметками.
Шаг 3 — подключи сборку
- В репозитории: Add file → Create new file.
- В поле имени введи:
.github/workflows/publish.yml(слэши создадут папки). - Вставь содержимое publish.yml из шаблона — он сам подставит твой ник и имя репозитория. Если заметки лежат не в
vault/, поменяй строкуvault-dir: vault(для корня —vault-dir: .). - Commit changes.
- Включи Pages: Settings → Pages → Source: GitHub Actions.
- Вкладка 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'а нет или хочется сначала пощупать — начни с шаблона в пару кликов, а заметки перенесёшь потом.