Ссылки и теги

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

Ссылка на страницу

Наберите две открывающие квадратные скобки и начните печатать название — появится список страниц проекта. Подпись можно задать свою:

[Быстрый старт](/5b632731-bd61-4004-a8e4-aba3a4e9113e)
[как это делается](/5b632731-bd61-4004-a8e4-aba3a4e9113e)

Ссылка живёт в тексте, а не в метаданных. Поэтому она переживает выгрузку в markdown, приезжает вместе с документом на другой контур и понятна агенту, который пишет страницу через MCP.

Ссылаться можно на то, чего ещё нет. Если страницы с набранным названием нет, последним пунктом списка стоит «Создать «…»» — он вставит ссылку на будущую страницу. Название, которому не нашлось страницы, остаётся в тексте как есть — это не ошибка, а пометка «сюда нужен документ». Появится страница с таким названием — ссылка оживёт.

Тег

Решётка со словом прямо в тексте — #релиз — или отдельный блок тегов под названием страницы. Наружу они не различаются: и то и другое одинаково видно в фильтре и одинаково приезжает агенту.

По тегам фильтруют, а не ищут. «Покажи всё, что помечено #релиз» — это не вопрос к поиску, а сужение списка: несколько тегов складываются по «И», и в выдаче остаются страницы, помеченные всеми сразу. Теги проекта собраны на вкладке «Теги» окна быстрого перехода (Ctrl+K), клик по тегу на странице или на дашборде открывает экран поиска с этим фильтром. Фильтр живёт в адресе — ссылкой на отфильтрованный список можно поделиться. См. Поиск по базе знаний.

Теги в нижнем регистре и без пробелов: #постмортем, #черновик, #api.

Полезные наборы обычно про состояние документа (#черновик, #утверждено, #устарело) или про область (#биллинг, #инфраструктура). Тег, повторяющий название раздела дерева, не добавляет ничего — вложенность уже это сказала.

Что из этого получается

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

Ещё одно следствие: под страницей есть панель «Связи» — кто на неё ссылается, на что ссылается она, какие теги и кто писал. Обратные ссылки специально проставлять не нужно, они находятся сами.

Как этим пользуются

Решение — ссылкой на разбор. В плане работ стоит Постмортем 05.08.2026, а не пересказ того, что там написано.
Термин — ссылкой на определение. Одно место, где слово объяснено, и десяток ссылок на него из документов, где оно употреблено.
Тег — то, что режет базу поперёк дерева. Если признак совпадает с веткой дерева, он уже выражен вложенностью.