Quarto CLI
Quarto — CLI для научных публикаций: текст, вычисления и графики собираются в отчет, книгу, сайт или презентацию.
- 6 155 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- При рендере исполняемые блоки документа запускаются через вычислительный движок с правами пользователя.
Установка
Ручная установка
git clone https://github.com/quarto-dev/quarto-cli
cd quarto-cli
./configure.shПервый реальный способ README: development version для Linux/macOS.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- При рендере исполняемые блоки документа запускаются через вычислительный движок с правами пользователя.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Quarto — CLI для выпуска научных и технических документов из Markdown. Автор соединяет текст с исполняемыми блоками Python, R, Julia или JavaScript, затем собирает публикацию вместе с результатами вычислений. Pandoc преобразует подготовленное содержимое в выбранный выходной формат. Проектная конфигурация объединяет несколько документов, общие настройки и навигацию книги или сайта. При редактировании режим `preview` пересобирает документ и показывает результат в браузере. Для текста без вычислений можно работать с обычным редактором.
Для кого. Исследователям и аналитикам, которые публикуют результаты вычислений вместе с объяснением и воспроизводимым исходником.
Подходит, если
- Аналитик меняет данные и пересобирает отчет с графиками.
- Преподаватель объединяет главы учебного материала в книгу.
- Команда ведет технический сайт с общими настройками документов.
- Автор проверяет текст и вывод кода в браузере до выпуска публикации.
Не подходит, если
- Чужой документ содержит непроверенный исполняемый код, а рендер запускают с рабочими доступами.
- Пользователю нужен только конвертер простых слайдов без проекта публикации.
- В окружении нет движка вычислений, но документ требует выполнения блоков Python или R.
Пример запроса к агенту
Проверь исходник Quarto и его блоки кода, затем собери копию отчета в изолированном окружении и покажи результат.Ограничения
В первом способе пользователь ставит версию для разработки через клонирование и `configure.sh` либо `configure.cmd`, поэтому этот способ не равнозначен готовому стабильному пакету. Исполняемые блоки зависят от выбранного движка, например Jupyter или Knitr, и его окружения. Рендер таких блоков запускает код документа с доступами текущего пользователя. Общие настройки проекта хранятся отдельно от текста, поэтому при переносе публикации надо сохранить и конфигурацию, и ее исходные файлы.
Как отключить. Остановите `quarto preview` и удалите вызовы рендера из заданий. Исходники `.qmd`, настройки проекта и выпущенные документы сохранятся.
Частые вопросы
Клонирование репозитория установит стабильную версию?
Команды `git clone https://github.com/quarto-dev/quarto-cli`, `cd quarto-cli`, `./configure.sh` ставят версию для разработки на Linux/macOS. Для стабильной версии выберите готовый установщик на https://quarto.org/docs/get-started/.
Как увидеть документ при редактировании?
Официальное руководство дает `quarto preview hello.qmd`. Команда собирает документ и открывает браузер; после сохранения исходника обновляет просмотр.
Как получить DOCX?
В руководстве приведено `quarto render hello.qmd --to docx`. Сначала подставьте свой исходник и просмотрите исполняемые блоки, затем откройте созданный документ.
Где хранятся общие параметры проекта?
В корневом `_quarto.yml`. При переносе книги или сайта сохраните этот файл вместе с документами, иначе общие форматы и настройки проекта потеряются.
Что исполняет Python-код в `.qmd`?
Для такого документа руководство описывает Jupyter: он получает блоки и возвращает результаты перед обработкой Pandoc. Подготовьте нужное Python-окружение до рендера.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыpresenterm показывает Markdown-слайды в терминале с подсветкой кода, изображениями, заметками и экспортом PDF или HTML.
MCP-сервер на базе pandoc: агент конвертирует Markdown, HTML, DOCX, LaTeX, EPUB, ODT и другие форматы друг в друга
Скилл-конвейер документов: что угодно в markdown, markdown в аккуратный html и docx уровня издательства, html обратно в markdown
Docling — CLI для смешанного архива: PDF, документы и таблицы можно привести к общему формату для поиска и ИИ.
Papis — CLI для научной библиотеки, из которой исследователь выгружает ссылки в BibTeX и открывает PDF в привычном приложении.
Скилл и CLI от Firecrawl: агент переводит Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV и PDF в Markdown на вашей машине
Коротко о README
README связывает Markdown, Pandoc и вычислительные движки. Редактирование возможно в VS Code, JupyterLab, RStudio и других редакторах. Отдельный проект собирает сайт или книгу из группы документов.