Цитирование и перекрёстные ссылки

Документ всё время указывает на свои части: «по лемме 2», «см. рисунок ниже», «как в предыдущем разделе». В LibreTimes Markdown это делается обычной ссылкой на якорь — имя, которое вы даёте блоку, на который хотите сослаться.

Ссылка на блок в том же документе

Дайте блоку якорь {#имя} и сошлитесь на #имя:

:::theorem[Лагранж]{#lagrange}
Порядок подгруппы делит порядок группы.
:::
 
По [теореме Лагранжа](#lagrange) у группы простого порядка нет собственных
подгрупп, кроме тривиальной.

Ссылка ведёт читателя к блоку, а адрес страницы с #lagrange на конце можно передать другим.

Что может нести якорь:

Правила для имени, которое вы выбираете:

• Оно начинается с латинской буквы, дальше латинские буквы, цифры, -, _, . или :, всего до 100 символов. Иначе имя отбрасывается и у блока нет якоря.
• Каждое имя — один раз. Если у двух блоков одно имя, его получает первый, и ссылки ведут к нему.
• Имя с . или : пишется как {id="eq-2.1"}: короткая форма с # обрывается на точке.
• Выбирайте имя по тому, что это за блок (#lagrange, #fig-orbit), а не где он стоит (#theorem-3): номер меняется, когда выше добавляется теорема, а имени меняться незачем.

Текст ссылки пишете вы. «Теорема 3» сама не подставится, поэтому если у утверждения есть печатный номер, впишите его в текст ссылки: [Теорема 3.17](#monotone).

Ссылка на блок в другой работе

Добавьте якорь к адресу другой работы. На опубликованной странице перед выбранным вами именем стоит user-content-, чтобы имя никогда не совпало с частями самой страницы; ссылка внутри того же документа поправляется на это автоматически, а ссылка извне пишет его явно:

Вместо <work-id> подставьте идентификатор из адреса другой работы.

Синтаксис [@ключ]

Квадратные скобки с @ и ключом зарезервированы для ссылок на источники, разрешаемых по библиографии, и для нумерованных перекрёстных ссылок:

Сегодня опубликованная страница показывает этот текст ровно так, как он написан. Он пока не заменяется на автора и год или на «Рисунок 2». Что синтаксис уже делает — сохраняет ваш текст в целости:

• [@knuth1974] никогда не превращается в ссылку на профиль, хотя ключ похож на упоминание.
• Адрес вроде ada@example.org — не ссылка на источник: перед @ стоит буква.
• Если какая-то часть скобок не разбирается, вся скобка остаётся обычным текстом.

Анализ Кнута [@knuth1974, p. 33] покрывает общий случай.

Это синтаксис, который читает и пишет pandoc. Файл LaTeX или Word, импортированный на сайте, его не использует: ссылки на источники приходят нумерованными метками вроде [1], а библиография становится списком литературы работы.

Как указать источник сегодня

Чтобы читатель мог перейти к источнику, укажите его в сноске с DOI или ссылкой на arXiv:

Известно, что оценка точна.[^knuth]
 
[^knuth]: D. E. Knuth, "Structured programming with go to statements",
    *Computing Surveys* 6 (1974). <https://doi.org/10.1145/356635.356640>