太平洋時間12月1日まで
SciFig
無料で始める
チュートリアル··更新日

Mermaidの図を画像に出力:SVG・PNG・PDFガイド

Mermaidの図をPNG・SVG・PDFに出力する方法を、Live Editor・mermaid-cli・VS Code・CI別に解説。PNGがぼやける・小さい・切れるときの対処法も紹介。

SciFig Team
SciFig Team
SciFig 編集チーム

Mermaid図はLive Editorかmmdcで、PNGやSVGに書き出せます。

結論: Mermaidの図を1枚だけ画像に出力するなら、Mermaid Live Editorに図を貼り付け、ActionsパネルからPNGかSVGをダウンロードします。繰り返しの出力や一括出力には、mermaid-cliのmmdcコマンドを使えば、.mmdやMarkdownのファイルをSVG・PNG・PDFに変換できます。編集可能な投稿用の図が必要な場合は、SciFig フローチャート(FlowChart)が説明文からAIで図を描き直し、ボックス・ラベル・矢印をすべて編集でき、SVG・PNG・PPTXで書き出せます。
何もインストールせずにMermaidの図を画像として保存したい場合は、コードをSciFigのMermaid PNG変換ツールに貼り付けます。ブラウザーで図を描画し、書き出し倍率(1×〜4×)と白または透明の背景を選んで、PNGかSVGを無料でダウンロードできます。

Mermaidはテキストから図を描画できるため、バージョン管理するドキュメントと相性のよいツールです。ただし、論文やスライド、ポスターに使う画像として保存するには、出力形式とサイズを指定する必要があります。PNGのピクセル数が足りないと、想定した大きさで印刷したときにぼやけて見えることがあります。

目的方法形式インストールコードは外部に送られるか
今すぐ1枚だけMermaid Live Editor → Actions → PNG または SVGPNG、SVG不要送られる(ホスト型のWebページに貼り付け)
繰り返し・一括出力mermaid-cli(mmdc)SVG、PNG、PDFNode.js、またはnpxで1回だけ実行送られない(ローカルで描画)
Markdownを書きながらプレビューVS Codeの拡張機能やObsidianプレビュー。一部の拡張機能はSVG/PNGを出力エディターの拡張機能送られない
常に最新のドキュメントCIのビルド工程でmmdcを実行SVG、PNG、PDFパイプライン内CI内にとどまる
編集可能な投稿用の描き直しSciFig フローチャート:図を説明するか、Mermaidのテキストを.mdファイルとして添付すると、AIがボックス・ラベル・矢印をすべて編集できる形で描き直すSVG、PNG、JPG、PPTX不要(ブラウザーで動作)送られる(SciFigにアップロード)

最後の行は種類の異なるツールです。Mermaidのコードを描画するのではなく、AIが説明文からネイティブSVGとして図を描き直すため、ノード・ラベル・矢印はすべて、移動やスタイル変更ができ、投稿先の表現に合わせて配置できる要素として出力されます。無料で始められ、カード登録は不要です。初日に150クレジットが付与され、編集とSVG・PNG・PPTXの書き出しは無料です。

Mermaidのフローチャートを記述したテキストと、出力されたSVGを並べた例(図はSciFigで生成)
Mermaidのフローチャートを記述したテキストと、出力されたSVGを並べた例(図はSciFigで生成)

コマンドラインで出力する

公式ツールの@mermaid-js/mermaid-cliには、mmdcコマンドが用意されています。
npm install -g @mermaid-js/mermaid-cli
 
mmdc -i diagram.mmd -o diagram.svg          # vector, preferred
mmdc -i diagram.mmd -o diagram.pdf          # vector PDF
mmdc -i diagram.mmd -o diagram.png -s 3     # raster at 3x scale
提出先や使用先が対応しているなら、SVGかPDFを選びましょう。 ベクター形式の線や文字は拡大しても鮮明に表示できますが、埋め込んだラスター画像の解像度は元のままです。PNGを使う場合は拡大倍率を指定し、出力後のピクセル数が印刷サイズと必要な解像度を満たしているか確認します。
形式ベクター対応向いている用途避けたい条件
SVGベクター要素を格納可能Web掲載、出力後の編集使用先がSVGに対応していない
PDFベクター要素を格納可能論文、印刷、スライド取り込み先の編集ソフトで必要な要素を保持できない
PNG非対応プレビュー、ラスター画像が必要な用途最終的な表示・印刷サイズに対してピクセル数が足りない
mmdcはMarkdownも読み込めます。mmdc -i notes.md -o notes-rendered.mdを実行すると、ファイル内のmermaidコードブロックをすべて画像に描画し、その画像を参照するMarkdownのコピーを書き出します。図の多いREADMEや実験ノートに便利です。

AI科学図表生成を実践で見る

研究者がテキストの説明から出版可能な科学図表を作成する様子をご覧ください。

ツールを探索

MermaidをPNGに出力する方法(ぼやける・小さい・切れるときの対処)

Mermaidの図からPNGファイルを作るには、mmdcの出力ファイル名を.pngで終わる名前にします。PNGは図の範囲に合わせてトリミングされ、そのサイズは二つの設定、つまり図を配置するページ幅と拡大倍率で決まります。「PNGがうまく出ない」という悩みの多くは、次のいずれかで解決できます。
PNGがぼやける:倍率を上げる。 -sはレイアウトを変えずにピクセル密度を高めます。スライドには-s 2、印刷には-s 3か-s 4が目安です。
mmdc -i diagram.mmd -o diagram.png -s 3
横長の図で文字が小さい:ページを広げる。 -wはページ幅(既定は800 px)、-Hはページの高さ(既定は600 px)を指定します。Mermaidは横長の図をページに収まるよう縮小するため、左から右へ長いフローチャートではラベルが読めなくなることがあります。ページを広げれば、ラベルは本来の大きさのまま保たれます。
mmdc -i diagram.mmd -o diagram.png -w 1600 -s 2
切れる・詰まる:まずSVGで出力する。 ラベルが切れたり詰まったりする場合は、SVGで描画してブラウザーで開きます。SVGが正しく見えるなら、原因はページサイズか倍率です。SVGもおかしい場合は、ラベルを短くするか、向きを変えます(graph LRではなくgraph TD)。
図の背後に白い四角が出る:背景を透明にする。 -bはPNGとSVGの背景を指定します(PDFは対象外)。既定は白です。
mmdc -i diagram.mmd -o diagram.png -b transparent -s 3
フォントやテーマが違う:設定ファイルにまとめる。 -cでMermaidのJSON設定を読み込めば、出力するすべての図で同じフォントとテーマを使えます。-tは1回の実行に組み込みテーマ(default、forest、dark、neutral)を指定します。
{
  "theme": "neutral",
  "themeVariables": { "fontFamily": "Arial" }
}
mmdc -i diagram.mmd -o diagram.png -c config.json -s 3
エディターのテーマは引き継がれない。 VS Codeのダークテーマ、Obsidianのダークモード、エディターの画面で選んだテーマは、プレビューの見た目を変えるだけです。出力ファイルには、図に書かれたテーマ(initの行やフロントマター)か、mmdcに渡したテーマが使われます。出力がプレビューと違って見える場合は、テーマを図に書き込みましょう。
mmdcをインストールできない:npxで実行する。 管理の厳しいマシンでは、グローバルインストールに失敗することがあります。npxならCLIをキャッシュにダウンロードして1回だけ実行するため、グローバルインストールは不要です。初回はヘッドレスブラウザーもダウンロードするため、数分かかります。
npx -y @mermaid-js/mermaid-cli -i diagram.mmd -o diagram.png -s 3

タイムラインとシーケンス図の例

次の最小限の例も、同じコマンドで出力できます。それぞれ.mmdファイルとして保存してください。
Mermaidのタイムラインの例(画像/PNG):
timeline
    title Research project timeline
    2024 : Grant awarded
    2025 : Pilot study : Data collection
    2026 : Analysis : Manuscript submitted
mmdc -i timeline.mmd -o timeline.png -s 3
Mermaidのシーケンス図の例:
sequenceDiagram
    participant R as Researcher
    participant S as Sequencing core
    participant P as Analysis pipeline
    R->>S: Submit samples
    S-->>R: Raw reads
    R->>P: Run QC and alignment
    P-->>R: Results table
mmdc -i sequence.mmd -o sequence.svg

ほかの出力方法

Mermaid Live Editor。 ブラウザーのエディターでは、ActionsパネルからSVGとPNGを直接出力でき、1枚だけ出力するなら最も手早い方法です。ただし図をホスト型のサービスに貼り付けることになるため、内容の機密性には注意が必要です。機密情報を含む図には、ローカルのCLIを使いましょう。
SciFigのMermaid PNG変換ツール。 MermaidのコードをMermaid PNG変換ツールに貼り付けてプレビューを描画し、PNGかSVGをダウンロードします。PNGをくっきりさせたいときは1×〜4×のうち高い倍率を選び、色付きのスライドに載せるときは透明背景を選びます。構文エラーがあると、壊れた画像を書き出す代わりにエラーの位置を表示するので、その行を直して描画し直せます。
VS Code。 Mermaidのプレビュー拡張機能を使うと、文書を書きながら図を表示できます。ただし、画像出力への対応は拡張機能によって異なります。SVG・PNG・PDFの出力方法を明確に指定したい場合は、上記のCLIを使えます。
CIパイプライン。 mmdcはCLIなので、図の生成をビルド工程に組み込めます。よく使われる方法は、.mmdのソースをコミットし、ドキュメントのビルド時に画像を生成することです。ソースを更新するたびに描画し直せば、画像だけが古いまま残るのを防げます。
- run: npm install -g @mermaid-js/mermaid-cli
- run: mmdc -i docs/architecture.mmd -o docs/architecture.svg
Mermaidのソースをリポジトリに保存し、ドキュメントのビルド時に画像を生成するCIの流れ(図はSciFigで生成)
Mermaidのソースをリポジトリに保存し、ドキュメントのビルド時に画像を生成するCIの流れ(図はSciFigで生成)

Obsidian・VS Codeからの出力と、論文やスライドへの組み込み

Obsidian。 Obsidianはノートのプレビューでmermaidコードブロックを描画しますが、図を1枚だけ画像ファイルとして保存するボタンは標準では用意されていません。ノートをPDFに出力すれば図も含まれます。単独のPNGやSVGが必要なら、コードブロックをMermaid Live Editorにコピーするか、.mmdファイルとして保存してmmdcを実行します。mmdcはMarkdownを読み込めるので、ノートそのものを指定することもできます。
VS CodeとMarkdownのプレビュー。 Mermaidのプレビュー拡張機能を使えば、入力しながら図を確認できます。VS CodeでMarkdown内のMermaidの図をPNGとして出力するには、出力に対応した拡張機能を使うか、図をMarkdownと同じ場所の.mmdファイルに置き、統合ターミナルからmmdcで描画します。
論文とスライド。 PNGではなくSVG(LaTeXならPDF)で出力します。PowerPointではSVGを図として挿入します。最近のバージョンでは図形に変換して、ボックスの色を変えることもできます。IllustratorやInkscapeでSVGを開き、間隔、フォント、矢印の先端を調整してから原稿に配置しましょう。-s 3以上のPNGは、投稿システムがベクターファイルを受け付けない場合に限って使います。
同じMermaidフローチャートを既定のテーマとneutralテーマで描画し、印刷時の読みやすさを比較した例(図はSciFigで生成)
同じMermaidフローチャートを既定のテーマとneutralテーマで描画し、印刷時の読みやすさを比較した例(図はSciFigで生成)

見た目を調整する

Mermaidの既定のスタイルはドキュメント向けです。論文などに使う場合は、次の3点を調整するとよいでしょう。

  • テーマ。 図のYAMLフロントマターで、configの下にtheme: neutralを設定します。印刷用のテーマを決める前に、実際に使うサイズでプレビューしてください。
  • フォント。 設定のfontFamilyでフォントを指定し、描画環境にそのフォントがインストールされていることを確認します。
  • 向き。 graph LRとgraph TDでは図の縦横比が変わります。論文の段幅に収める際には、この違いが効いてきます。

中立的なテーマと印刷向けのフォントを設定した、研究プロセスのフローチャートの例:

---
config:
  theme: neutral
  fontFamily: Helvetica
---
graph LR
  A[Sample collection] --> B[Extraction]
  B --> C[Sequencing]
  C --> D[Analysis]

Mermaid以外のツールが向いている場合

Mermaidはレイアウトを自動で計算するため、配置を細かく指定できる範囲には限りがあります。ドキュメントには便利ですが、配置そのものに意味がある科学図表では制約になります。

Mermaidが向いている場面SciFig フローチャート(FlowChart)やベクター編集ソフトに切り替える場面
バージョン管理するドキュメント投稿先の図の表現に合わせる必要がある論文の図
ビルドのたびに再生成する図ボックス単位で制御したい厳密な配置
自動レイアウトで十分な図解剖学的な位置や時間の順序など、実際の関係を反映する配置
レビューで差分を追えるテキストだけのソースコードではなく見た目で図を編集する共著者

Mermaidで図の骨組みを作り、SVGに出力してからベクター編集ソフトで仕上げる方法もあります。ただし、手作業で加えた仕上げの編集は、Mermaidのソースから再生成しても再現されません。

Mermaidで自動配置した図と、同じ内容を論文用に手動で配置し直した図の比較(図はSciFigで生成)
Mermaidで自動配置した図と、同じ内容を論文用に手動で配置し直した図の比較(図はSciFigで生成)
もう一つの方法は、SciFig フローチャートで描き直すことです。図を自然な言葉で説明するか、Mermaidのテキストを.mdファイルとして添付すると、テキストから図を生成するツールがAIで編集可能なネイティブSVGの図を描き、ボックス・ラベル・矢印はすべて直接移動やスタイル変更ができます。上のシーケンス図の例のようなやり取りなら、シーケンス図ジェネレーターが参加者とメッセージについて同じことを行います。無料で始められ、初日に150クレジットが付与され、編集・保存とSVG・PNG・PPTXの書き出しは無料です。テンプレート型のデザインツールも比較したい場合は、図解向けのCanva代替ツールをご覧ください。

ヒント

.mmdのソースと出力画像は、一緒にコミットしましょう。ソースはレビューで変更点を追いやすく、内容が変わったときに図を再生成できます。画像は、完成した見た目を確認するために必要です。どちらか一方だけを残すと、変更の確認か閲覧の手軽さが損なわれます。

今すぐ科学図表を作成

自然言語で科学図表を説明 — 数分で出版可能なイラストを取得。

無料で試す
図解以外の論文用の図には、SciFigのテキストから科学図表を作る機能でイラストを作成できます。全体の流れは研究内容を図にするためのガイドで紹介しています。

関連記事

関連する読み物: AIテキストから図で研究を即座に可視化, 2026年の最高の科学イラストレーションツール10選, 無料のCanva代替アプリ7選(2026年):科学図表の作成・投稿向けツール.

よくある質問

さらに活用する

おすすめのリソース

研究に役立つテンプレート・ツール・関連記事

コールトゥアクションの背景

始める準備はできましたか?

数分で出版可能な科学図表を

無料で作成開始

無料で開始 ・ クレジットカード不要 ・ 研究者向けに構築