Marp CLI
Marp CLI пересобирает слайды при сохранении Markdown или темы: автор просматривает результат, пока правит текст.
- 3 907 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- CLI читает Markdown и записывает презентации; некоторые экспорты запускают локальный браузер.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/marp-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI читает Markdown и записывает презентации; некоторые экспорты запускают локальный браузер.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Marp CLI преобразует текстовые слайды Marp и Marpit в готовую презентацию из командной строки. Автор редактирует Markdown, запускает конвертацию и получает файл для показа или отправки. Режим наблюдения пересобирает результат после изменения текста или темы. В серверном режиме браузер получает выбранный формат по запросу. Это движок вывода, который можно вызывать из скриптов и CI; отдельный скилл Marp задает агенту правила подготовки содержания, но не заменяет установленный конвертер.
Для кого. Преподавателям и техническим авторам, которые хранят слайды в Markdown и повторяют сборку после правок.
Подходит, если
- Докладчик правит содержание слайдов рядом с кодом в Git.
- Преподаватель выгружает PDF из той же версии, что показывает в HTML.
- Команда включает сборку презентации в CI.
- Редактор использует watch, чтобы видеть изменения темы и текста в браузере.
Не подходит, если
- Заказчик требует обычный PPTX с редактируемыми фигурами без экспериментального режима.
- В окружении нет браузера, а задача требует экспорта PDF или PPTX.
- Автор собирается разрешить локальные файлы для Markdown неизвестного происхождения.
Пример запроса к агенту
Собери эти Markdown-слайды Marp в HTML, затем покажи план экспорта PDF и не разрешай доступ к локальным файлам без причины.Ограничения
Для запуска через Node.js нужна версия 18 или новее. Экспорт PDF, PPTX и изображений требует Chrome, Edge либо Firefox. Обычный PPTX содержит готовые изображения слайдов; экспериментальный редактируемый вариант дополнительно требует LibreOffice и может менять внешний вид. Локальные файлы для браузерной конвертации по умолчанию заблокированы, а флаг `--allow-local-files` автор советует применять только к доверенному Markdown.
Как отключить. Остановите процесс watch или сервера и уберите вызов Marp из сборки. Исходные Markdown и готовые презентации останутся на диске.
Частые вопросы
Как попробовать без постоянной установки?
Запустите `npx @marp-team/marp-cli@latest slide-deck.md`, подставив свой Markdown. Команда создаст HTML без постоянной установки пакета; для запуска нужен Node.js 18 или новее.
Как установить пакет в проект?
Автор рекомендует `npm install --save-dev @marp-team/marp-cli` для контроля версии. После установки команда доступна через npm scripts или `npx marp`.
Как получить PDF?
Пример README: `npx @marp-team/marp-cli@latest slide-deck.md --pdf`. Установите совместимый браузер и замените имя входного файла.
Будет ли PPTX редактируемым?
Обычно слайды сохраняются как изображения. Для правки объектов есть `marp --pptx --pptx-editable slide-deck.md`, но режим экспериментальный: проверьте верстку и учтите отсутствие заметок докладчика.
Как обновлять результат при правках?
Пример `npx @marp-team/marp-cli@latest -w slide-deck.md` включает наблюдение. Оставьте процесс запущенным и откройте HTML; сохранение Markdown вызовет пересборку.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыpresenterm показывает Markdown-слайды в терминале с подсветкой кода, изображениями, заметками и экспортом PDF или HTML.
Три скилла и черная тема Marp для докладов: сюжет, схемы и дизайн слайдов плюс скрипты, которые измеряют готовый PDF
CLI форматирует Markdown для публикации, создает HTML с оформлением, извлекает обычный текст и исправляет разметку файла.
MCP-сервер, который превращает PDF, DOCX, XLSX, PPTX, изображения, аудио, веб-страницы и расшифровки YouTube в Markdown
Mermaid CLI обрабатывает диаграммы внутри Markdown: создает SVG и заменяет текстовые блоки ссылками на готовые изображения.
Скилл и CLI превращают Markdown в DOCX, PDF, PPTX, XLSX, PNG и еще десяток форматов, все считается локально
Коротко о README
Темы задают оформление Markdown-слайдов, а заметки докладчика остаются частью исходника. Для отправки презентации есть HTML, PDF и обычный PPTX. Экспериментальный редактируемый PPTX отличается ограничениями, включая отсутствие заметок.