Блоки цитат Markdown: цитаты, несколько абзацев и списки
Создавайте цитаты Markdown с помощью >, вкладывайте их друг в друга и цитируйте несколько абзацев. Отличайте уведомления GitHub от переносимого синтаксиса перед экспортом в Word.
Блок цитаты Markdown начинается с > и следующего за ним пробела. Ставьте маркер в начале каждой цитируемой строки, чтобы исходник было удобно читать и редактировать.
> Обновлённое руководство по установке готово к проверке.
В результате получается цитируемый абзац, а не блок кода. Его граница, отступ и цвет зависят от темы страницы или документа. Текст цитаты остаётся обычным Markdown, поэтому может содержать выделение, ссылки, списки и другие элементы структуры документа.
Проверьте примеры в просмотрщике Markdown, затем экспортируйте документ через конвертер Markdown в Word, если нужна редактируемая копия для проверки.
Цитирование абзаца на нескольких строках исходника
В длинной цитате повторяйте маркер:
> Обновлённое руководство по установке готово к проверке.
> Пожалуйста, проверьте предварительные требования перед утверждением выпуска.
В предпросмотре этого сайта две строки исходника образуют один абзац. Перевод строки в исходнике не обязательно вызывает видимый перенос. Если формулировка должна оставаться на двух строках, добавьте явный перенос:
> Проверка документации\
> Назначена ответственному за выпуск
Обратная косая черта ставится перед переводом строки; следующая строка по-прежнему начинается с маркера цитаты. Различие между принудительными переносами и разрывами абзацев объясняется в статье о переносах строк Markdown.
Несколько абзацев в одной цитате
Поставьте маркер цитаты на пустой строке между абзацами:
> Первый черновик описывает процесс установки.
>
> Второй черновик добавляет шаги устранения неполадок и примеры.
Так создаётся один блок цитаты с двумя абзацами. Сохранение > на разделяющей строке делает группировку очевидной, особенно при дальнейшем редактировании другим человеком.
Чтобы вернуться к собственному тексту, оставьте пустую строку и продолжите без маркера:
> По результатам проверки попросили сократить раздел об установке.
Мы перенесли подробные замечания по настройке в приложение.
Не убирайте > из строки продолжения, не добавив пустую строку. Некоторые анализаторы Markdown считают это неявным продолжением цитируемого абзаца. Такое поведение описывает спецификация блоков цитат CommonMark. Явные маркеры и чёткое отделение пустой строкой проще поддерживать совместно.
Выделение, ссылки и указание источника
Содержимое блока цитаты поддерживает обычное встроенное форматирование:
> **Замечание при проверке:** Для шагов миграции нужен рабочий пример.
> См. [контрольный список выпуска](https://example.com/checklist).
>
> Отзыв по результатам проверки документации, сентябрь 2026 года.
Markdown не назначает последней строке особую роль ссылки на источник. Это обычное содержимое абзаца внутри цитаты. При необходимости укажите источник, автора и ссылку, а перед воспроизведением чужого фрагмента проверьте права на его использование.
Блок цитаты также не добавляет буквальные кавычки. Введите их самостоятельно, если они нужны в итоговом документе. Для короткой цитаты, встроенной в ваше предложение, обычных кавычек может быть достаточно без отдельного блока.
Вложенная цитата или список
Для цитируемого материала внутри внешней цитаты используйте дополнительный уровень >:
> Рецензент кратко изложил предыдущий запрос:
>
> > Добавить полный пример файла конфигурации.
>
> Теперь обновлённый черновик содержит этот пример.
Не делайте вложенность в отчёте слишком глубокой. Глубоко вложенные цитаты уменьшают доступную ширину текста, что может ухудшать читаемость PDF и Word.
У списка внутри цитаты маркер сохраняется на каждой строке:
> Проверка выявила два необходимых изменения:
>
> - Объяснить требуемые разрешения.
> - Добавить раздел устранения неполадок.
Для обратной структуры, цитаты внутри списка, задайте отступ под текстом пункта:
- Отзыв о документации
> Добавить раздел устранения неполадок перед публикацией.
- Контрольный список выпуска
Если цитата появляется вне пункта, сравните её отступ с примерами в руководстве по отступам Markdown.
Уведомления GitHub требуют поддержки целевой платформы
GitHub поддерживает специальные уведомления на основе синтаксиса цитат, в том числе такую форму:
> [!NOTE]
> Создайте резервную копию конфигурации перед её изменением.
Поддерживаемые типы перечислены в справочнике уведомлений GitHub. Цвета и значки уведомлений являются функциями платформы, а не свойством любой цитаты Markdown.
Средство отображения этого сайта не добавляет оформление уведомлений GitHub. Пример остаётся блоком цитаты с видимой меткой [!NOTE]. Чтобы документ хорошо читался на разных платформах, используйте явную жирную подпись:
> **Примечание:** Создайте резервную копию конфигурации перед её изменением.
Так смысл остаётся понятным без специального расширения для уведомлений. Тот же подход подходит для предупреждения, решения по результатам проверки или редакторского замечания.
Устранение проблем с цитатами перед экспортом
Если > отображается буквально, проверьте, не находится ли пример между обратными кавычками, в ограждённом или в отступном блоке кода. Эти контексты предназначены для показа исходного текста. Обратная косая черта перед маркером тоже экранирует его.
Если в цитату попадает лишний текст, добавьте пустую строку перед абзацем, который должен продолжаться вне цитаты. Если вложенный материал трудно воспринимать, уменьшите вложенность и добавьте сведения об источнике обычным абзацем.
Наконец, откройте экспортированный DOCX и проверьте длинные цитаты и списки внутри цитат. Левая граница в браузере и стили абзацев в Word могут различаться. Используйте инструмент Markdown в HTML для проверки промежуточной структуры, если нужно отличить проблему форматирования исходника от проблемы оформления экспорта.