コンテンツにスキップ

なぜ ippon か(Marp・Slidev・reveal.js との違い)

ippon は「1 枚 1 メッセージ」のスライドを、できるだけ少ない手間で作るための CLI です。 Markdown からスライドを作る道具はほかにもあります。このページでは、ippon が何を選び、 何を選ばなかったかと、ほかの道具のほうが向いている場面をまとめます。

1 枚 1 メッセージ(高橋メソッド)

ippon は 高橋メソッド を前提にしています。1 枚のスライドには短い言葉を 1 つだけ、画面いっぱいの大きさで出します。 スライドは読ませる資料ではなく、話を後押しする合図です。箇条書きを詰め込みたくなったら、 それはスライドを分ける合図です。

そのため ippon には、テーマやレイアウトを選ぶ仕組みがほとんどありません。黒地に大きな文字という 1 種類の見た目を既定にし、書き始めてすぐ発表できることを優先しています。

ほかの道具との違い

ippon Marp Slidev reveal.js
書き方 Markdown(独自の記法は少し) Markdown Markdown と Vue のコンポーネント HTML(Markdown はプラグインで)
出力 HTML 1 ファイル、PDF、OGP 画像 HTML、PDF、PPTX、画像 Web アプリ、PDF、PPTX、PNG HTML(PDF はブラウザの印刷で)
見た目 1 種類。CSS 変数で調整 CSS でテーマを作れる テーマとレイアウトが豊富 テーマとプラグインが豊富
必要なもの Node.js だけ(依存ゼロ)。PDF は手元の Chrome Node.js。PDF などは手元のブラウザ Node.js のプロジェクト。書き出しに Playwright ブラウザ(開発には Node.js)
発表の補助 発表者ビュー、スマホのリモコン、タイマー 発表者ビュー 発表者モード、描画、録画 スピーカービュー

比較は ippon から見た大まかなものです。各ツールの最新の機能は公式のドキュメント (Marp、Slidev、reveal.js)を確認してください。

ippon が向いているとき

  • 言いたいことを 1 枚ずつ大きく見せたい(LT、勉強会、社内の発表など)。
  • 資料を HTML 1 ファイルで配りたい。オフラインでも、何年後でも開けるようにしたい。
  • プロジェクトを作らず、npx ですぐに使いたい。依存を増やしたくない。
  • コードや API のレスポンスを見せたい(コードのハイライト、::http::)。
  • スマホで操作しながら発表したい(ippon serve)。

ほかの道具が向いているとき

  • 細かいレイアウトや図、アニメーションを作り込みたい → Slidev や reveal.js。
  • PowerPoint(PPTX)のファイルで渡す必要がある → Marp や Slidev。
  • 1 枚にたくさんの情報を載せた、読ませる資料を作りたい → Marp や、Google スライド・PowerPoint などのアプリ。

ippon に入れないもの

  • テーマやレイアウトの種類を増やすこと。見た目の調整は CSS 変数 の範囲にとどめます。
  • ランタイムの依存パッケージ。PDF もブラウザを同梱せず、手元の Chrome を使います。
  • 外部のサービス。発表者ビューもスマホのリモコンも、ブラウザと Node.js の標準機能だけで動きます。

迷ったら、足すのではなく削る。スライドからも、この道具からも。