Научно-издательская система Quarto

практическое руководство

Автор

Е.Н. Матеров

Дата публикации

20 марта 2026 г.

Введение

В настоящее время все большую популярность набирает научно-издательская система Quarto, которая представляет собой унифицированную систему для авторов, позволяя соединять код на языках программирования R, Python, Julia, Observable JS и его результаты с повествовательным текстом, что делает его незаменимым инструментом в науке о данных. Здесь есть все, что необходимо для комфортной работы студенту или научному исследователю, а также тем, кому необходимо представить свои результаты.

Вот лишь некоторые ключевые функции Quarto:

  1. Поддержка множества различных выходных форматов. В Quarto можно создавать интерактивные книги, презентации, веб-страницы, дэшборды и многое другое на основе единого источника текста. В качестве выходных форматов для экспорта могут служить как веб-страницы, так и форматы *.pdf, MS Word, *.epub, и другие. Это стало возможным благодаря использованию универсального конвертера Pandoc.
  2. Формат Markdown для редактирования. Работа с документом Quarto происходит полностью в текстовом редакторе с использованием простого текстового формата, а итоговый документ (скажем, *.pdf) формируется только на последнем этапе во время рендеринга. Это позволяет эффективно писать в соавторстве и активно использовать распределенную систему управления версиями Git.
  3. Интеграция кода. В Quarto имеется возможность встраивать и выполнять код на различных языках программирования (R, Python, Julia и JavaScript) непосредственно в документе.
  4. Шаблонизация. Документы Quarto могут создаваться на основе шаблонов и поддерживают динамическое обновление при изменении параметров или данных. Доступны такие функции, как перекрестные ссылки, расширенные макеты, всплывающие цитаты, сноски и многое другое.
  5. Автоматическая нумерация. Нумерация разделов, рисунков, таблиц и других элементов выполняется автоматически. Кроме того, в Quarto предусмотрена автоматизация работы с библиографией.
  6. Совместимость с современными редакторами. Формат Quarto совместим со многими IDE, такими как RStudio, Visual Studio Code, Positron, Cursor, Neovim, а также блокнотами, включая JupyterLab и marimo.

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

Книга содержит следующие части:

  • Начало работы с Quarto
    Этот раздел посвящен основам, необходимым для начала работы в Quarto. Здесь вы узнаете, как настроить рабочее окружение в IDE, использовать язык разметки, а также создавать базовые элементы документа.
  • Примеры проектов в Quarto
    В этом разделе представлены практические примеры создания различных основных типов контента: веб-страниц, статей, блогов, презентаций и книг.
  • Специальные вопросы
    Цель данной части состоит в том, чтобы рассмотреть специальные вопросы, связанные с Quarto, такие как, например, создание дэшбордов, использование Wasm в Quarto для выполнения кода на R или Python на стороне клиента без необходимости в сервере (через проекты webR и Pyodide), создание параметрических шаблонов, интеграцию с Typst, а также другие вопросы.
Совет

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

В первую очередь книга ориентирована на авторов, которые используют в своей деятельности язык программирования R, однако основы и принципы работы с научно-издательской системой Quarto не зависят от базового языка программирования, и книга может быть полезной для всех, кто программирует также на Python или Julia. Книга проиллюстрирована практическими примерами, а элементы кода можно копировать для использования в собственных проектах.

Важное уведомлениеВажное замечание

Данное издание не является всеобъемлющим руководством по издательской системе Quarto. На официальном сайте Quarto имеется полное руководство, подробно излагающее большинство тем, рассмотренных в данной книге.

Кроме того, следует отметить, что в настоящий момент готовится к изданию книга Quarto: The Definitive Guide, которая подробно рассматривает различные концептуальные аспекты работы с Quarto.

Благодарности

В первую очередь необходимо отметить авторов Quarto: Carlos Scheidegger, Charles Teague, Christophe Dervieux, J.J. Allaire, Yihui Xie, а также тех, кто внес огромный вклад в развитие и продвижение Quarto: Mine Çetinkaya-Rundel, Charlotte Wickham, Mickaël Canouil, Emil Hvitfeldt, James J Balamuta.

Автор благодарит читателей Telegram-канала Наука и данные за активность.