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

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

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

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

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

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

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

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

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

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

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

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

При написании больших научных документов неудобно вручную отслеживать порядковые номера [^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 при экспорте в PDF для сдачи курсовой, диплома или отчета (подробнее об этом читайте в нашей инструкции по экспорту Markdown-заметок в PDF), обычные HTML-конвертеры не справляются с постраничным разбиением.

В редакторе Labkeeper встроен специализированный движок PDF-экспорта: он анализирует границы печатных листов A4 и размещает сноски строго на том листе, где встретился маркер, отделяя их стандартной типографической полосой по ГОСТ.

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

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

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