Как сделать кликабельные сноски в Markdown документе

Зачем нужны сноски в Markdown

В академических отчетах, статьях и технической документации часто требуется дать уточнение, ссылку на источник или комментарий автора, не перегружая основной текст. В классической типографике для этого используются сноски внизу страницы Markdown (footnotes). Если же вы готовите курсовую или дипломную работу по праву или истории, ознакомьтесь также с правилами оформления постраничных сносок по ГОСТ.

Оригинальная спецификация Markdown Джона Грубера не содержала встроенного механизма для примечаний, но большинство современных диалектов — включая Markdown Extra, GitHub Flavored Markdown (GFM) и онлайн-редактор Labkeeper — поддерживают стандартный механизм сносок с автоматической нумерацией и двусторонней навигацией (клик ведет к примечанию, а стрелка возврата — обратно в текст).

В Labkeeper текст делится на сегменты, и каждый Markdown-сегмент обрабатывается отдельно: маркер и определение сноски должны стоять в одном сегменте, а нумерация в превью начинается заново в каждом сегменте.

Как сделать сноски footnote в Markdown: базовый синтаксис

Разберем детально, как сделать сноски footnote в Markdown с помощью стандартных маркеров. Для этого требуются два связанных элемента: маркер вызова в тексте и определение самого примечания.

Маркер оформляется квадратными скобками со знаком каретки: [^идентификатор]. Расшифровка начинается с новой строки тем же маркером с двоеточием:

По данным недавнего исследования[^1], скорость сходимости алгоритма увеличилась в два раза.

[^1]: Результаты численного эксперимента приведены в сводном отчете лаборатории за 2026 год.

Что происходит при рендеринге:

• В месте маркера [^1] браузер отобразит аккуратную верхнюю цифру-ссылку ¹.
• Текст примечания автоматически переместится в блок сносок в конце текста (в Labkeeper — в конце того же сегмента).
• В конце текста сноски автоматически генерируется ссылка возврата ↩, возвращающая читателя точно к прочитанному абзацу.

Именованные сноски (текстовые метки)

При написании больших научных документов неудобно вручную отслеживать порядковые номера [^1], [^2], [^3]. Гораздо удобнее использовать смысловые текстовые метки на латинице:

Мы использовали стандартный метод оптимизации[^adam] для обучения нейронной сети.
Также была применена регуляризация весов[^weight-decay].

[^adam]: Kingma D. P., Ba J. Adam: A Method for Stochastic Optimization. ICLR, 2015.
[^weight-decay]: Значение коэффициента затухания было зафиксировано на уровне 1e-4.

Парсер автоматически заменит метки [^adam] и [^weight-decay] на строгие порядковые номера 1 и 2 в порядке их первого упоминания в документе.

Многострочные сноски и списки внутри сноски

Если примечание состоит из нескольких абзацев, содержит маркированный список или блок исходного кода, все последующие строки блока должны иметь отступ в 4 пробела (или один Tab):

Основной вывод эксперимента описан в протоколе[^protocol].

[^protocol]: Первый абзац подробного примечания.

    Второй абзац сноски обязательно имеет отступ в 4 пробела,
    чтобы парсер понимал, что он относится к текущей сноске.

    * Пункт 1 в сноске
    * Пункт 2 в сноске

Сноски внизу страницы Markdown: правила переноса и рендеринг в PDF

В браузере все примечания собираются единым блоком в конце текста. В Markdown-проекте Labkeeper так же: сноски стоят в конце сегмента, а при сохранении в PDF через печать браузера этот блок остаётся в конце, а не переносится вниз каждого листа (подробнее о печати читайте в инструкции по сохранению Markdown в PDF).

Если для курсовой, диплома или отчета нужны настоящие сноски внизу страницы Markdown, создайте в Labkeeper LaTeX-проект и пишите текст в Markdown-сегменте. При сборке сервер переводит Markdown в LaTeX: каждая сноска [^1] становится командой \footnote, и pdfLaTeX ставит примечание внизу того листа, где стоит маркер, под короткой разделительной линией. Нумерация в PDF идёт сквозная по всему документу. Требования к сноскам в курсовых по праву и истории разобраны в статье о постраничных сносках по ГОСТ.

Частые ошибки при наборе сносок

• Пробел внутри скобок: [^ 1] — синтаксическая ошибка. Знак вставки и идентификатор пишутся слитно: [^1].
• Отсутствие двоеточия: В определении сноски двоеточие строго обязательно: [^1]: Текст.
• Кириллические символы в метках: Чтобы избежать конфликтов кодировок в компиляторах, используйте в метках латиницу, цифры и дефис: [^source-2026].

Практические советы