Тот же Markdown, теперь публично

Из заметок Obsidian в сайт

Q: Можно опубликовать только часть хранилища?

Да. Страницей становится только то, что лежит в content/ . Держите отдельную папку для публичных заметок.

Сделать сайт из заметок Obsidian можно потому, что Obsidian уже хранит каждую заметку обычным файлом Markdown. Генератор статических сайтов, например HERON, читает эти файлы и собирает из них публичный сайт: быстрые страницы с тегами для поиска, бесплатный хостинг, а заметки остаются источником.

Ниже — что переносится как есть, что нужно чуть поправить и как опубликовать хранилище целиком или частью, по шагам.

Что переносится

В Obsidian	На сайте HERON
Заметка `Рецепты/Хлеб.md`	Страница по адресу вроде `/recipes/bread/`
Папка заметок	Раздел со списком его страниц
Заголовки, списки, таблицы, жирный, код	То же, без изменений
Свойства в начале заметки	Блок настроек страницы: `title`, `h1`, `description`
Ссылки `[[Хлеб]]` между заметками	Обычные ссылки Markdown: `[Хлеб](адрес)`
Вставки `![[photo.jpg]]`	Картинки `![Буханка хлеба](/media/bread.jpg)` из `media/`
Выноски `> [!note]`	Цитата `>`
Теги, граф, холст	Не публикуются

Что поправить в заметках

Ссылки

HERON читает обычные ссылки Markdown. Ссылки в двойных квадратных скобках нужно один раз переделать, а дальше писать ссылки обычным способом.

Для новых заметок: В Obsidian: Настройки → Файлы и ссылки → выключите «Использовать [[Вики-ссылки]]». Новые ссылки будут записываться в обычном виде.
Для старых заметок: Переделайте один раз поиском с заменой или плагином сообщества, либо поручите ИИ-агенту пройти по всей папке.
Как выглядит обычная ссылка: [Первый сайт](/docs/first-site/): текст в квадратных скобках, адрес в круглых.
Ссылки на свои страницы: Пишите адрес от корня без языковой приставки, например /recipes/bread/. HERON сам подставит правильный адрес для каждого языка.
Проверка: Сборка перечисляет каждую ссылку, которая никуда не ведёт, с файлом и строкой, поэтому битая ссылка не проскочит.

Настройки страницы

Каждая страница начинается с короткого блока настроек — там же, где Obsidian хранит свойства. Важнее всего три поля, у остальных есть подсказки рядом.

title: Строка в результатах поиска, до 60 знаков. Например: Хлеб на закваске дома: простой рецепт.
h1: Заголовок на странице. Может быть короче title: Хлеб на закваске.
description: Одно-два предложения для выдачи, до 155 знаков: что читатель получит на странице.
Свойства Obsidian, которые уже есть: date можно оставить: HERON читает его как дату публикации. Для остальных свойств запустите heron check .: отчёт скажет, какие поля не принимаются.
Самый простой старт: Скопируйте страницу, которую создал HERON, оставьте её блок настроек и вставьте под ним свою заметку.

Секции

Длинные заметки делятся на секции с коротким ярлыком после заголовка. Именно ярлык позволяет теме нарисовать список карточками, шагами или таблицей.

Как писать: ## Ингредиенты {#ingredients} вместо ## Ингредиенты.
Зачем: Ярлык — это адрес секции, /recipes/bread/#ingredients, и подсказка теме, как её показать.
Ярлыки: Латиница, цифры и дефис: {#how-to-bake}. Каждый ярлык — один раз на странице.
Вступление: Оставьте один-два абзаца до первой секции. Если их больше, строгая сборка назовёт файл.
Что во что превращается: Нумерованный список — в шаги, таблица — в таблицу, вопросы с ### — в блок вопросов. Все варианты — в справочнике форм.

Картинки и личные заметки

Картинки кладутся в папку media/, личные заметки остаются вне папки сайта. Опубликовать можно только то, что лежит в content/.

Картинки: HERON сделает WebP и AVIF всех размеров, поэтому крупные фото — не проблема.
Как вставить: ![Хлеб на доске](media/examples/photo.jpg). Текст в квадратных скобках — описание для тех, кто не видит картинку; не оставляйте его пустым.
Личные заметки: Публикуются только файлы из content/. Держите хранилище отдельно и копируйте публичное или ставьте странице published: false.
Черновики: published: false не пускает страницу на сайт. noindex: true публикует её, но прячет от поиска и из llms.txt.
Вложения: PDF и другие файлы тоже кладутся в media/, ссылка на них ставится как на страницу.

По шагам

1
Создайте сайт

Одна команда берёт последний образ HERON, и образ создаёт папку сайта с темой и демо-страницами.
2
Скопируйте заметки

Положите публичные заметки в папку вашего языка внутри content/, сохранив папки.
3
Поправьте ссылки и настройки

Как описано выше. Сборка перечислит каждую битую ссылку с файлом и строкой.
4
Посмотрите

Откройте localhost:8000 и пройдитесь по страницам.
5
Опубликуйте

Когда всё готово, опубликуйте готовый сайт выбранным способом. Для заметок хорошо подходит бесплатный: GitHub Pages со своим доменом.
Хранение и публикация
6

Публикация на GitHub Pages со своим доменом
7

Страницы и секции подробно
8

Как секции становятся блоками: справочник форм

А писать дальше в Obsidian можно?

Да. Откройте папку content/ сайта как хранилище Obsidian и пишите как привыкли. Git хранит историю, каждый push публикует изменения. Правило одно: обычные ссылки и блок настроек вверху.

Вопросы

Это замена Obsidian Publish?

Для публичных сайтов — да. Obsidian Publish — платный сервис, который сохраняет вид Obsidian, граф и вики-ссылки. HERON собирает сайт, который принадлежит вам и размещается где угодно бесплатно, а взамен нужно чуть подготовить ссылки и настройки страниц.

Можно опубликовать только часть хранилища?

Да. Страницей становится только то, что лежит в content/. Держите отдельную папку для публичных заметок.

Найдут ли страницы поисковики?

Да. У каждой страницы свой адрес, заголовок, описание, место в карте сайта и llms.txt и теги, которые ждут поисковики.

Можно сделать сайт на двух языках?

Да. Заметки на втором языке кладутся в папку этого языка внутри content/ с теми же именами файлов. Подробнее — многоязычный сайт.