Цитаты и разделители

Цитата помечает чужие слова: отрывок из обсуждаемой статьи, определение из учебника, замечание рецензента. Горизонтальная линия помечает разрыв в самом тексте. Оба приёма — обычный CommonMark, поэтому работают здесь так же, как в любом другом месте, где вы пишете на Markdown.

Цитаты

Начните каждую строку с > и пробела:

Результат

Математика – это искусство называть разные вещи одним и тем же именем.

— Анри Пуанкаре

Markdown

> Математика -- это искусство называть разные вещи одним и тем же именем.
>
> --- Анри Пуанкаре

Пустая строка с > оставляет подпись внутри той же цитаты вторым абзацем. Без неё подпись приклеится к цитируемой фразе. Три дефиса (---) становятся длинным тире, так что подпись получает типографское тире без ручного ввода.

Маркер нужен только в первой строке

Абзац, начатый внутри цитаты, продолжается и на следующих строках без >. В CommonMark это называется ленивым продолжением:

Результат

Теория вероятностей в сущности есть не что иное, как здравый смысл, сведённый к исчислению.

Markdown

> Теория вероятностей в сущности есть не что иное,
как здравый смысл, сведённый к исчислению.

Это удобно, когда вставляете длинный отрывок. Следующему блоку (новому абзацу, списку, заголовку) всё равно нужен свой >, поэтому если цитата длиннее одного абзаца, ставьте маркер в каждой строке. Именно так пишет и редактор.

Что может быть внутри

Цитата вмещает любые блоки: несколько абзацев, списки, код, выносные формулы и другие цитаты. Вложенная цитата — ещё один >:

Результат

Рецензент пишет:

Во второй лемме предполагается непрерывность $f$ , но используется только ограниченность $f$ на $[0, 1]$ .

Оба замечания учтены в исправленной версии:

Условие леммы 2 ослаблено до ограниченности.

Доказательство $\int_{0}^{1} f \leq sup f$ теперь ссылается на неё.

Markdown

> Рецензент пишет:
>
> > Во второй лемме предполагается непрерывность $f$, но используется
> > только ограниченность $f$ на $[0, 1]$.
>
> Оба замечания учтены в исправленной версии:
>
> 1. Условие леммы 2 ослаблено до ограниченности.
> 2. Доказательство $\displaystyle\int_0^1 f \le \sup f$ теперь ссылается на неё.

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

Цитата, выноска или эпиграф?

На странице эти три конструкции похожи, а значат разное:

Что	Для чего	Как писать
Цитата	Чужие слова внутри вашего рассуждения	`> ...`
Выноска	Ваше собственное примечание, совет или предупреждение читателю	`:::note`
Эпиграф	Цитата в начале главы или документа, задающая тон всему, что дальше	`:::epigraph`

Выбирайте по смыслу, а не по виду. Программа чтения с экрана, поисковик и экспорт в LaTeX обращаются с ними по-разному и рассчитывают, что вы выбрали ту, что говорит, чем текст является.

Выноски GitHub здесь не работают

GitHub показывает > [!NOTE] как цветную выноску. Здесь это остаётся обычной цитатой, первая строка которой — [!NOTE]. Документ, написанный так, при импорте переводится в форму :::note; вручную же сразу пишите выноску.

Горизонтальная линия

Три дефиса или больше на отдельной строке дают горизонтальную линию — разрыв между двумя частями текста:

Результат

Первая часть рассуждения заканчивается здесь.

Вторая часть начинается с другого предположения.

Markdown

Первая часть рассуждения заканчивается здесь.
 
---
 
Вторая часть начинается с другого предположения.

Звёздочки (***) и подчёркивания (___) дают ту же линию. Пробелы между символами допустимы (- - -).

Пустая строка перед линией обязательна

Ставьте пустую строку перед линией из дефисов. Прямо под строкой текста --- не рисует линию, а превращает этот текст в заголовок (старую «подчёркнутую» форму заголовка). Если абзац вдруг стал заголовком, почти всегда причина — пропущенная пустая строка над ---. У формы *** такой ловушки нет.

Линия или заголовок

Линия говорит «разрыв в тексте» — и ничего больше. У неё нет названия, якоря и строки в оглавлении. Если у новой части есть тема, которую можно назвать, лучше поставить заголовок: читатель увидит структуру и сможет на неё сослаться. Линия подходит для разрывов без названия — смены сцены в эссе или паузы перед заключительным замечанием. В книге линия и есть разрыв сцены и набирается соответственно.