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

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

Автор

Е.Н. Матеров

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

17 марта 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-канала Наука и данные за активность.