Repolode
投稿する
marp-team

marp-team/marp-cli

Marp/MarpitのMarkdownスライドをHTML、PDF、PPTX、PNG/JPEG画像に変換するCLIツール。

代替できる製品:PowerPointKeynote

GitHub で見る
スター
3,907
フォーク
205
未解決の Issue
20
最終コミット
2 か月前

これは何？

Marp CLIは、MarpやMarpitフレームワークを基盤とする各種コンバーター向けのコマンドラインインターフェースです。Marp構文で書かれたMarkdownファイルを、静的なHTMLとCSS、PDF、PowerPoint（PPTX）、PNGまたはJPEG画像に変換します。PDF、PPTX、画像への変換には、ローカルにインストールされたChrome、Edge、またはFirefoxを使用します。

単発の変換に加えて、ファイルの変更時に再ビルドして開いているページを更新するwatchモード、HTTP経由でリクエストに応じてスライドを変換するサーバーモード、プレゼンテーション用のプレビューウィンドウを利用できます。出力には、発表者ノート、PDFのアウトライン、タイトル、作者、Open Graph画像などのメタデータを含められます。テーマの上書きや、カスタムCSSの指定にも対応しています。

Marp CLIはnpxで実行できるほか、npmからローカルまたはグローバルにインストールしたり、Docker経由で使ったり、単体バイナリをダウンロードしたりできます。また、Node.js APIと、プロジェクト全体の設定に使える設定ファイル（marp.config.js、.marprc、またはpackage.jsonのmarpセクション）も提供しています。

主な機能

  • 01MarkdownのスライドをHTML、PDF、PPTX、PNG/JPEG画像に変換します。
  • 02watchモードでは、変更時に再ビルドしてブラウザーを自動更新します。
  • 03サーバーモードではスライドを配信し、クエリ文字列を使ったリクエストに応じて変換します。
  • 04プレビューウィンドウと、キーボード操作に対応した独自のHTMLテンプレートを利用できます。
  • 05発表者ノートの出力とPDFのアウトラインに対応しています。
  • 06CLIフラグ、設定ファイル、Node.js APIから設定できます。

ユースケース

  • Markdownで技術発表のスライドを作成し、配布用PDFに出力する。
  • MarkdownからPowerPointファイルを生成し、Officeを使う同僚と共有する。
  • Dockerを使い、CIやドキュメントのパイプラインでスライド生成を自動化する。
  • スライドのタイトルページからOpen Graph画像を作成する。

クイックスタート

  1. 1

    Node.js v18以降をインストールする

  2. 2

    npxでスライドデッキをHTMLに変換する

    npx @marp-team/marp-cli@latest slide-deck.md
  3. 3

    スライドデッキをPDFに変換する（Chrome、Edge、Firefoxのいずれかが必要）

    npx @marp-team/marp-cli@latest slide-deck.md --pdf

使う前に知っておきたいこと

  • PDF、PPTX、画像への変換には、Google Chrome、Microsoft Edge、Mozilla Firefoxのいずれかがインストールされている必要があります。
  • 実験的な --pptx-editable オプションにはLibreOffice Impressも必要で、スライドの再現性が低下します。

収録されている特集

CLI・ターミナルツールPDF・OCR・ドキュメント処理ツール静的サイトジェネレーターとドキュメントツール

トピック

#markdown#presentation#slides#pdf#pptx#cli#marp#deck#marpit

よくある質問

marp-cli とは？
Marp/MarpitのMarkdownスライドをHTML、PDF、PPTX、PNG/JPEG画像に変換するCLIツール。 Marp CLIは、MarpやMarpitフレームワークを基盤とする各種コンバーター向けのコマンドラインインターフェースです。Marp構文で書かれたMarkdownファイルを、静的なHTMLとCSS、PDF、PowerPoint（PPTX）、PNGまたはJPEG画像に変換します。PDF、PPTX、画像への変換には、ローカルにインストールされたChrome、Edge、またはFirefoxを使用します。
marp-cli は無料で使えますか？ライセンスは？
marp-cli は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
marp-cli は今もメンテナンスされていますか？
半年以内に更新あり。marp-cli の最終コミットは 2026年9月8日 です。
marp-cli は何に使えますか？
Markdownで技術発表のスライドを作成し、配布用PDFに出力する。 MarkdownからPowerPointファイルを生成し、Officeを使う同僚と共有する。 Dockerを使い、CIやドキュメントのパイプラインでスライド生成を自動化する。 スライドのタイトルページからOpen Graph画像を作成する。
marp-cli のインストール方法は？
Node.js v18以降をインストールする npxでスライドデッキをHTMLに変換する: npx @marp-team/marp-cli@latest slide-deck.md スライドデッキをPDFに変換する（Chrome、Edge、Firefoxのいずれかが必要）: npx @marp-team/marp-cli@latest slide-deck.md --pdf
marp-cli はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/marp-team/marp-cli

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト