A CLI tool for converting Marp/Marpit Markdown slide decks into HTML, PDF, PowerPoint, and images.
Marp CLI is a command-line interface that converts Markdown files written in Marp/Marpit syntax into various presentation formats like HTML, PDF, PowerPoint, and images. It solves the problem of creating and maintaining slide decks with code, offering a reproducible, version-controlled workflow for developers and technical presenters.
Developers, technical writers, and educators who create presentations regularly and prefer writing slides in Markdown with the ability to export to standard formats for sharing or presenting.
Developers choose Marp CLI for its flexibility in output formats, deep integration with the Marp ecosystem, and extensibility through custom engines and themes, all while keeping the simplicity of Markdown-based slide creation.
A CLI interface for Marp and Marpit based converters
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Converts Markdown slides to HTML, PDF, PPTX, and images with single commands, as demonstrated in the basic usage section with examples like 'marp --pdf slide-deck.md'.
Includes watch mode for auto-refresh and server mode for on-demand HTTP conversion, enabling real-time editing and previewing during development, shown in the conversion modes section.
Allows swapping the underlying engine to Marpit or custom engines via '--engine' option, and supports functional engines for plugin integration, detailed in the engine section.
Offers 'bespoke' and 'bare' HTML templates with features like slide transitions and presenter views, customizable through CLI options like '--bespoke.progress'.
Requires Google Chrome, Microsoft Edge, or Mozilla Firefox for PDF, PPTX, and image conversions, adding an external dependency and potential setup hurdles, as warned in usage notes.
Blocks access to local files by default during browser-based conversions for security, requiring the risky '--allow-local-files' option, which complicates workflows with local assets.
The editable PPTX conversion is labeled experimental and may throw errors or produce incomplete results with complex themes, limiting its use for reliable PowerPoint editing.