FAQ
Сайт открывается, но «голый»: нет стилей, заметки не грузятся, 404 в консоли
Почти всегда это baseHref. На GitHub Pages сайт живёт на под-пути /имя-репозитория/, и сборка должна об этом знать:
- в workflow:
base-href: /имя-репозитория/(см. GitHub Pages); - на Netlify/Vercel/Cloudflare сайт живёт в корне — там оставь
/.
Я задеплоил изменения, а сайт показывает старое
Браузер цепко кэширует статические файлы. Жми Ctrl+Shift+R (жёсткая перезагрузка) или открой в инкогнито. Особенно это касается canvas-досок — они грузятся отдельным файлом.
Как скрыть часть заметок?
buildMode: public в Конфигурация — публикуются только заметки с publish: public во frontmatter. Остальные не попадают ни в сборку, ни в поиск, ни в граф.
Кириллические имена файлов — это ок?
Да. Адреса страниц сохраняют кириллицу (/заметки/моя-заметка), как у Obsidian Publish. Этот сайт — живой пример.
Какие ссылки между заметками понимаются?
И [[wikilinks]] (с |алиасом, #заголовком), и обычные [текст](другая-заметка.md). Оба вида попадают в граф и обратные ссылки.
Картинки и вложения?
Клади рядом с заметками и вставляй как обычно: ![[картинка.png]] или . При сборке файлы получают хэш-имена и попадают на сайт.
Сколько это стоит?
Сам markdown-publish — бесплатный и открытый (MIT). GitHub Pages, Netlify, Vercel и Cloudflare Pages имеют бесплатные тарифы, которых хватает для личных заметок с запасом.
Это официальный продукт Obsidian?
Нет. Проект не аффилирован с Obsidian.MD — он просто читает совместимый формат vault'ов и .canvas-файлов (открытый стандарт JSON Canvas).
Не нашёл ответа — задай вопрос в issues.