Сноски

Как ставить сноски через [^метка], писать длинные и многоабзацные примечания и где они показываются и как нумеруются

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

Синтаксис

У сноски две половины. Ссылка [^метка] ставится в тексте сразу после слова или знака препинания, к которому относится. Определение [^метка]: текст пишется отдельной строкой в любом месте документа:

Результат

Позже оценку улучшили до .1

Markdown
Позже оценку улучшили до $O(n \log n)$.[^tao2019]
 
[^tao2019]: T. Tao, «Universality of random matrices», 2019.

Отрисованное примечание — в самом низу этой страницы, под последним разделом, со стрелкой, которая возвращает к месту ссылки. В публикации всё так же.

Как работает нумерация

  • Читатель видит номера, а не ваши метки. Примечания нумеруются 1, 2, 3 в порядке первой ссылки в тексте, а не в порядке определений. [^tao2019] показывается как надстрочный номер.
  • Метки — для вас. Выбирайте такие, по которым понятно, что это за примечание ([^tao2019], [^набросок]), — так его легко найти при правке. Метка — слово без пробелов. Цифры тоже годятся ([^1]), но описательная метка переживает перестановку, а номер в исходнике быстро перестаёт совпадать с порядком.
  • Ссылка на одну сноску дважды использует тот же номер, а у примечания появляется по стрелке на каждую ссылку.
  • Определение без единой ссылки не выводится, а ссылка без определения остаётся буквальным текстом [^метка] — опечатка видна на странице, а не теряется молча.

Длинные примечания

Примечание может содержать несколько абзацев, список или выносную формулу. Всё после первой строки сдвиньте на четыре пробела:

Результат

Формула Стирлинга точна даже при малых .2

Markdown
Формула Стирлинга точна даже при малых $n$.[^стирлинг]
 
[^стирлинг]: При $n = 10$ относительная ошибка меньше процента.
 
    Следующий член асимптотического ряда даёт
 
    $$
    n! \approx \sqrt{2\pi n}\left(\frac{n}{e}\right)^n \left(1 + \frac{1}{12n}\right).
    $$

Внутри любого примечания работают оформление текста, ссылки и строчные формулы.

Где писать определения

Где угодно: положение определения не влияет на то, где выводится примечание. В длинном документе помогают две привычки:

  • Рядом с абзацем — пока пишете черновик и примечание часть мысли. Исходник тогда читается почти как страница.
  • В конце каждого раздела, как обычно собирают ссылки-сноски, — когда примечаний много и они короткие.

В любом случае держитесь одного способа в пределах документа.

Сноски и цитирование

Сегодня источник в документе указывают сноской. Синтаксис [@ключ] зарезервирован за ссылками на библиографию, но опубликованная страница пока не разрешает их: она показывает текст как написан. До тех пор цитируйте в сноске и давайте DOI или ссылку на arXiv, где они есть, — так читатель попадёт к источнику одним щелчком.

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

Footnotes

  1. T. Tao, «Universality of random matrices», 2019. ↩

  2. При относительная ошибка меньше процента.

    Следующий член асимптотического ряда даёт

    ↩