Mermaid図はLive Editorかmmdcで、PNGやSVGに書き出せます。
mmdcコマンドを使えば、.mmdやMarkdownのファイルをSVG・PNG・PDFに変換できます。編集可能な投稿用の図が必要な場合は、SciFig フローチャート(FlowChart)が説明文からAIで図を描き直し、ボックス・ラベル・矢印をすべて編集でき、SVG・PNG・PPTXで書き出せます。Mermaidはテキストから図を描画できるため、バージョン管理するドキュメントと相性のよいツールです。ただし、論文やスライド、ポスターに使う画像として保存するには、出力形式とサイズを指定する必要があります。PNGのピクセル数が足りないと、想定した大きさで印刷したときにぼやけて見えることがあります。
| 目的 | 方法 | 形式 | インストール | コードは外部に送られるか |
|---|---|---|---|---|
| 今すぐ1枚だけ | Mermaid Live Editor → Actions → PNG または SVG | PNG、SVG | 不要 | 送られる(ホスト型のWebページに貼り付け) |
| 繰り返し・一括出力 | mermaid-cli(mmdc) | SVG、PNG、PDF | Node.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-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 | ベクター要素を格納可能 | Web掲載、出力後の編集 | 使用先がSVGに対応していない |
| ベクター要素を格納可能 | 論文、印刷、スライド | 取り込み先の編集ソフトで必要な要素を保持できない | |
| PNG | 非対応 | プレビュー、ラスター画像が必要な用途 | 最終的な表示・印刷サイズに対してピクセル数が足りない |
mmdcはMarkdownも読み込めます。mmdc -i notes.md -o notes-rendered.mdを実行すると、ファイル内のmermaidコードブロックをすべて画像に描画し、その画像を参照するMarkdownのコピーを書き出します。図の多いREADMEや実験ノートに便利です。MermaidをPNGに出力する方法(ぼやける・小さい・切れるときの対処)
mmdcの出力ファイル名を.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 2graph 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 3mmdcに渡したテーマが使われます。出力がプレビューと違って見える場合は、テーマを図に書き込みましょう。mmdcをインストールできない:npxで実行する。 管理の厳しいマシンでは、グローバルインストールに失敗することがあります。npxならCLIをキャッシュにダウンロードして1回だけ実行するため、グローバルインストールは不要です。初回はヘッドレスブラウザーもダウンロードするため、数分かかります。npx -y @mermaid-js/mermaid-cli -i diagram.mmd -o diagram.png -s 3タイムラインとシーケンス図の例
.mmdファイルとして保存してください。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 3sequenceDiagram
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ほかの出力方法
mmdcはCLIなので、図の生成をビルド工程に組み込めます。よく使われる方法は、.mmdのソースをコミットし、ドキュメントのビルド時に画像を生成することです。ソースを更新するたびに描画し直せば、画像だけが古いまま残るのを防げます。- run: npm install -g @mermaid-js/mermaid-cli
- run: mmdc -i docs/architecture.mmd -o docs/architecture.svg
Obsidian・VS Codeからの出力と、論文やスライドへの組み込み
mermaidコードブロックを描画しますが、図を1枚だけ画像ファイルとして保存するボタンは標準では用意されていません。ノートをPDFに出力すれば図も含まれます。単独のPNGやSVGが必要なら、コードブロックをMermaid Live Editorにコピーするか、.mmdファイルとして保存してmmdcを実行します。mmdcはMarkdownを読み込めるので、ノートそのものを指定することもできます。.mmdファイルに置き、統合ターミナルからmmdcで描画します。-s 3以上のPNGは、投稿システムがベクターファイルを受け付けない場合に限って使います。
見た目を調整する
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のソースから再生成しても再現されません。

.mdファイルとして添付すると、テキストから図を生成するツールがAIで編集可能なネイティブSVGの図を描き、ボックス・ラベル・矢印はすべて直接移動やスタイル変更ができます。上のシーケンス図の例のようなやり取りなら、シーケンス図ジェネレーターが参加者とメッセージについて同じことを行います。無料で始められ、初日に150クレジットが付与され、編集・保存とSVG・PNG・PPTXの書き出しは無料です。テンプレート型のデザインツールも比較したい場合は、図解向けのCanva代替ツールをご覧ください。ヒント
.mmdのソースと出力画像は、一緒にコミットしましょう。ソースはレビューで変更点を追いやすく、内容が変わったときに図を再生成できます。画像は、完成した見た目を確認するために必要です。どちらか一方だけを残すと、変更の確認か閲覧の手軽さが損なわれます。関連記事
関連する読み物: AIテキストから図で研究を即座に可視化, 2026年の最高の科学イラストレーションツール10選, 無料のCanva代替アプリ7選(2026年):科学図表の作成・投稿向けツール.



