Сноски

Сноски — это расширенная функция Markdown, которая позволяет добавлять справочные примечания или дополнительную информацию, давая читателям возможность просматривать дополнительные объяснения, не прерывая процесс чтения.

Базовый синтаксис

Добавление сноски

В Markdown создание сноски включает два компонента: метку сноски и ее содержание.

Это текст с выноской[^1].

[^1]: Это содержание сноски.

Результат:

Это текст с выноской[^1].

[^1]: Это содержание сноски.

Несколько сносок

Markdown — это легковесный язык разметки[^1], созданный Джоном Грубером[^2], который теперь широко используется в области письма[^3].

[^1]: Markdown использует простой синтаксис для форматирования текста.
[^2]: Джон Грубер создал Markdown в 2004 году.
[^3]: Многие платформы, такие как GitHub, Stack Overflow и блог-платформы, поддерживают Markdown.

Результат:

Markdown — это легковесный язык разметки[^2]，созданный Джоном Грубером[^3], который теперь широко используется в области письма[^4].

[^2]: Markdown использует простой синтаксис для форматирования текста. [^3]: Джон Грубер создал Markdown в 2004 году. [^4]: Многие платформы, такие как GitHub, Stack Overflow и блог-платформы, поддерживают Markdown.

Расширенное использование

Идентификаторы сносок

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

Здесь обычная сноска[^1] и сноска с идентификатором[^note].

[^1]: Это обычная сноска.
[^note]: Это сноска с идентификатором.

Результат:

Здесь обычная сноска[^5] и сноска с идентификатором[^note].

[^5]: Это обычная сноска. [^note]: Это сноска с идентификатором.

Многопараграфные сноски

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

Это сноска с несколькими параграфами[^multipara].

[^multipara]: Это первый параграф сноски.

    Это второй параграф сноски. Отступ должен быть не менее четырех пробелов или одной табуляции.

    > В сноске также может быть блок цитирования.

    - Можно включать списки
    - Как упорядоченные, так и неупорядоченные

Результат:

Это сноска с несколькими параграфами[^multipara].

[^multipara]: Это первый параграф сноски.

Это второй параграф сноски. Отступ должен быть не менее четырех пробелов или одной табуляции.

> В сноске также может быть блок цитирования.

- Можно включать списки
- Как упорядоченные, так и неупорядоченные

Встроенные сноски

Некоторые реализации Markdown поддерживают синтаксис встроенных сносок, но это не является стандартом Markdown.

Это встроенная сноска^[добавление содержания сноски непосредственно в тексте, а не в конце документа].

Результат (на поддерживающих платформах):

Это встроенная сноска^[добавление содержания сноски непосредственно в тексте, а не в конце документа].

Совместимость и различия реализаций

Поддержка на разных платформах

Платформа/Инструмент	Стандартные сноски	Встроенные сноски	Многопараграфные сноски
GitHub Markdown	✅	❌	✅
GitLab Markdown	✅	✅	✅
Jekyll (kramdown)	✅	✅	✅
Hugo	✅	✅	✅
CommonMark	❌	❌	❌
VitePress	✅	✅	✅
Pandoc	✅	✅	✅

HTML-вывод

Большинство процессоров Markdown преобразуют сноски в HTML с ссылками и стрелками возврата:

<!-- Ссылка на сноску -->
<p>Это текст с выноской<sup id="fnref:1"><a href="#fn:1" class="footnote-ref">1</a></sup>.</p>

<!-- Содержание сноски (обычно в конце документа) -->
<div class="footnotes">
  <hr>
  <ol>
    <li id="fn:1">
      <p>Это содержание сноски.<a href="#fnref:1" class="footnote-backref">↩</a></p>
    </li>
  </ol>
</div>

Рекомендации и лучшие практики

Когда использовать сноски

Сноски подходят для следующих случаев:

1. Цитирование источников: Ссылки на научные работы, книги или другие справочные материалы
2. Дополнительные объяснения: Предоставление дополнительной информации без прерывания основного содержания
3. Дополнительное чтение: Предложение дополнительных ресурсов для заинтересованных читателей
4. Объяснение терминов: Разъяснение профессиональных терминов или аббревиатур

Рекомендации по типографике сносок

✅ Рекомендуемые практики:

1. **Размещение содержания сносок в конце**: Помещайте все определения сносок в конец документа для удобства поддержки
2. **Последовательность**: Используйте последовательный способ маркировки сносок (числа или осмысленные идентификаторы)
3. **Умеренность**: Слишком много сносок может отвлекать внимание читателей
4. **Значимое содержание**: Сноски должны добавлять реальную ценность, а не просто повторять основной текст

❌ Чего следует избегать:

1. Использование нескольких сносок в одном предложении
2. Использование сносок для отображения основной информации
3. Размещение слишком длинного содержимого в сносках
4. Вложенные сноски

Сноски в длинных документах

Для длинных документов можно группировать сноски по разделам:

# Глава 1

Это содержание первой главы с одной сноской[^1-1].

[^1-1]: Первая сноска первой главы.

# Глава 2

Это содержание второй главы с другой сноской[^2-1].

[^2-1]: Первая сноска второй главы.

Решение распространенных проблем

Сноски не отображаются

Если ваши сноски не отображаются:

1. Убедитесь, что идентификаторы и определения сносок полностью совпадают (с учетом регистра)
2. Проверьте, что определения сносок имеют правильный формат (после двоеточия должен быть пробел)
3. Проверьте, поддерживает ли ваш процессор Markdown синтаксис сносок
4. Попробуйте оставить пустые строки перед и после определений сносок

Беспорядочная нумерация сносок

Некоторые процессоры автоматически перенумеровывают сноски, даже если вы использовали пользовательские идентификаторы. Это ожидаемое поведение, и окончательное отображение обычно представляет собой последовательные числа.

Доступность на мобильных устройствах

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

Связанный синтаксис

• Ссылки - Базовый синтаксис ссылок
• Зачеркивание - Другие варианты форматирования текста
• Блоки кода с ограждением - Синтаксис блоков кода

Практика и применение

1. Создайте короткую статью с не менее чем тремя различными сносками
2. Попробуйте создать сноску с многопараграфным содержанием
3. Используйте сноски для цитирования источников в академической или технической статье

---

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