Markdown reference

Markdown記法集

Marplioで確認済みのMarkdownとスライド記法を、用途からすぐ引けるリファレンスです。

基本のMarkdown

文章の構造と強調に使う、標準的な記法です。

見出しと本文

行頭の`#`で見出しを作ります。記号の後ろに半角スペースを入れます。

記述例
# 大見出し

## 小見出し

文章はそのまま本文になります。
表示結果
大見出し、小見出し、本文として表示されます。

強調

太字、斜体、取り消し線を使い分けます。

記述例
**太字**

*斜体*

~~取り消し線~~
表示結果
指定した文字だけが強調されます。

箇条書き

行頭に`-`と半角スペースを置きます。

記述例
- 調査する
- 試作する
- 検証する
表示結果
項目が箇条書きで表示されます。

番号付きリスト

行頭に番号、ピリオド、半角スペースを置きます。

記述例
1. 調査する
2. 試作する
3. 検証する
表示結果
順序を持つリストとして表示されます。

引用

行頭に`>`と半角スペースを置きます。

記述例
> 重要な結論を、最初に伝える。
表示結果
引用文として装飾されます。

リンク

表示文字を角括弧、URLを丸括弧で囲みます。

記述例
[Marplio](https://marplio.com)
表示結果
クリックできるリンクとして表示されます。

インラインコード

短いコードや記号をバッククォート1つで囲みます。

記述例
`npm run build` を実行します。
表示結果
文章の中でコード部分だけが区別されます。

コードブロック

複数行のコードをバッククォート3つで囲みます。言語名も指定できます。

記述例
```ts
const message = "Hello, Marplio";
```
表示結果
改行と色付けを保ったコードブロックになります。

表

縦棒で列を分け、2行目で見出しと本文を区切ります。セル内の改行には`<br>`を使えます。

記述例
| 項目 | 結果 |
| --- | --- |
| 利用者 | +28%<br>前月比 |
| 時間 | -2h |
表示結果
見出し行を持つ表として表示されます。
現在の制限
列が多い表は1枚に詰め込まず、文字量を減らしてください。

Marp・Marplio記法

ページ分割やスライドの役割を指定する記法です。

貼り付けたMarkdownを整える

空のEditor、または全文を選択した状態へ、H1と1つ以上のH2を持つMarkdownを貼り付けると、見出しごとにスライドへ分割します。

表示結果
最初の見出しは表紙、続く見出しは本文スライドになります。一般的な箇条書き記号や番号もMarkdown記法へ揃えます。
現在の制限
既に`---`や`_class`があるDeck、コードブロック、frontmatterは書き換えません。意図と違う場合は1回の「元に戻す」で貼り付け前へ戻せます。

スライドを分ける

単独行の`---`で次のスライドを始めます。

記述例
# 1枚目

---

# 2枚目
表示結果
2枚のスライドとして生成されます。

ページ番号

先頭にpaginate directiveを置くと、以降のスライドへページ番号を表示します。

記述例
<!-- paginate: true -->

# 1枚目

---

# 2枚目
表示結果
各スライドにページ番号が表示されます。

見出しを横幅へ合わせる

`<!-- fit -->`を見出し内へ置くと、利用可能な横幅へ文字を自動調整します。

記述例
# <!-- fit --> Build less. Prove more.
表示結果
見出しが横幅へ収まるように拡大・縮小されます。
現在の制限
固定サイズではありません。短い主題だけに使い、通常の見出しには付けないでください。

スライドの役割

表紙、目次、中表紙、本文、締めの目的と、各役割に適した情報量を確認します。

表紙 `cover`

`cover`はDeckの表紙です。`#`を主題、`##`を補足に使います。

記述例
<!-- _class: cover -->

# 伝わる資料を、速く。

## 月次報告の作成フロー

2026.09 / Product team
向いている場面
Deckの最初に、主題・対象・発表者を短く示すとき。
避ける場面
本文や長い箇条書きを置くと主題が弱くなります。
基本構造
`#` 1件、必要なら`##` 1件と短いメタ情報。
表示結果
選択中のデザインに対応した表紙として表示されます。

目次 `agenda`

`agenda`は目次です。`##`の後に番号付きリストを置きます。

記述例
<!-- _class: agenda -->

## 本日の流れ

1. 現状と課題
2. 提案
3. 実行計画
4. 次の判断
向いている場面
3〜6章程度の全体像を先に共有するとき。
避ける場面
説明文を各項目へ詰め込まず、章名だけを並べます。
基本構造
`##` 1件、番号付きリスト3〜6件。
表示結果
章番号と章名を読みやすく並べた目次になります。

中表紙 `section-cover`

`section-cover`は章の中表紙です。`#`を章番号、`##`を章名に使います。

記述例
<!-- _class: section-cover -->

# 01

## 現状と課題

まず、判断を遅らせている要因を確認します。
向いている場面
話題が大きく変わる位置で、聞き手の認知を切り替えるとき。
避ける場面
根拠や結論まで書かず、章の切り替わりだけを示します。
基本構造
`#` 1件、`##` 1件、必要なら短い補足1件。
表示結果
章番号と章名を中央に置いた区切りのスライドになります。

本文 `content`

`content`は通常の本文です。`##`をそのスライドで伝える主張にします。

記述例
<!-- _class: content -->

## 報告作業を半分にする

- 入力形式を統一する
- 差分だけを確認する
- 判断と次の行動を残す
向いている場面
根拠、解釈、次の行動を1つの主張として説明するとき。
避ける場面
1枚へ複数の主張を詰め込まず、見出しを結論として書きます。
基本構造
`##` 1件、本文または箇条書き3〜5件。
表示結果
見出しと本文を持つ標準のスライドになります。

締め `closing`

`closing`は締めです。最後に残したい結論または次の行動を`#`へ書きます。

記述例
<!-- _class: closing -->

# 次回会議で、試行範囲を決める。

10月3日までに対象部署を選定
向いている場面
結論、依頼、次の行動を最後に再提示するとき。
避ける場面
「ありがとうございました」だけで終わらず、求める判断を明示します。
基本構造
`#` 1件、必要なら期限や連絡先など短い補足。
表示結果
Deckの結論を強く残す締めのスライドになります。

本文レイアウト

`content`へ表現classを加え、伝えたい関係に合う組版を選びます。各例の実表示をデザイン別に確認できます。

引用 `quote`

`quote`は引用を主役にするレイアウトです。

記述例
<!-- _class: content quote -->

## 利用者の声

> 月次報告の準備が、判断の時間に変わりました。

— 事業責任者
向いている場面
顧客の声、原文、原則など、引用元のある短い言葉を強調するとき。
避ける場面
通常の説明文を装飾目的で引用にしません。
基本構造
`##` 1件、引用1件、必要なら出典1件。
表示結果
引用符と余白を使い、短い言葉を大きく表示します。

2つの文章を比較 `two-column`

`two-column`は2つの小見出しと本文を左右へ揃えます。

記述例
<!-- _class: content two-column -->

## 2つの選択肢

### 現行を継続

開始は早いが、手作業が残る。

### 仕組みを共通化

準備は必要だが、次回も再利用できる。
向いている場面
現状と将来、案Aと案Bなど、2つの短い文章群を同じ重みで比べるとき。
避ける場面
左右で粒度や文量が大きく異なる内容には使いません。
基本構造
`##` 1件、`###` 2件、各見出し直後に本文またはリスト1件。
表示結果
2つの観点が同じ幅・同じ行位置で表示されます。

図や文章を2列に配置 `columns`

`columns`は左右を明示的に分け、見出し・文章・リスト・図を別々に配置します。

記述例
<!-- _class: content columns -->

## ファネルと次の打ち手(サンプル)

<!-- marplio:column left -->

### 根拠

- 対象者と現状
- 判断に必要な数字

<!-- marplio:column right -->

### 読み解き

この内容と数値は例です。実際の根拠に置き換えてください。

- 注目する変化
- 次に試すこと
向いている場面
図と説明、根拠と解釈など、種類の異なる要素を左右へ置くとき。
避ける場面
3列、列の入れ子、左右の開始コメントを省いた記述は使えません。
基本構造
`content columns`と、単独行のleft・right開始コメント。
表示結果
左右の要素が独立した列になり、対応する書き出しでも編集可能な要素を維持します。

左の図を強調 `columns-visual-left`

`columns-visual-left`は左列を広く、右列を狭くします。

記述例
<!-- _class: content columns columns-visual-left -->

## 幅に差を付けて主役を明確にする

<!-- marplio:column left -->

### 主要な根拠

**31%** 提案化率

前月から4pt改善

<!-- marplio:column right -->

### 読み解き

対象を絞った施策が改善に寄与。
向いている場面
左の図・表・数値を主役にし、右へ短い解釈を添えるとき。
避ける場面
左右を強調する理由がない場合は、幅が同じ`columns`を使います。
基本構造
`content columns columns-visual-left`と、left・right開始コメント。
表示結果
左列が約58%、右列が約42%の比率で表示されます。

右の図を強調 `columns-visual-right`

`columns-visual-right`は右列を広く、左列を狭くします。

記述例
<!-- _class: content columns columns-visual-right -->

## 幅に差を付けて主役を明確にする

<!-- marplio:column left -->

### 前提

同じ期間・同じ対象で比較

<!-- marplio:column right -->

### 判断

**31%** 提案化率

次月も施策を継続する
向いている場面
左に短い前提、右に大きな結論や表を置くとき。
避ける場面
左右を強調する理由がない場合は、幅が同じ`columns`を使います。
基本構造
`content columns columns-visual-right`と、left・right開始コメント。
表示結果
左列が約42%、右列が約58%の比率で表示されます。

KPI `kpi`

`kpi`は重要な数値と意味をカード状に並べます。

記述例
<!-- _class: content kpi -->

## 今月の主要指標

- **42件** 有効商談 / 前月比 +8
- **31%** 提案化率 / 前月比 +4pt
- **12日** 平均リードタイム / -3日
向いている場面
経営指標や成果を、3つまで同じ条件で一覧するとき。
避ける場面
数値の条件や単位を省略せず、4件以上は別のスライドへ分けます。
基本構造
`##` 1件、箇条書き3件。各項目の先頭を太字の数値にします。
表示結果
強調された数値と説明が3列で表示されます。

2案比較 `comparison`

`comparison`は2つの選択肢をカードとして比較します。

記述例
<!-- _class: content comparison -->

## 導入方法を比較

- **小さく試す** 1部署で2週間検証する
- **一括導入する** 全社ルールを先に整える
向いている場面
2案を同じ評価軸と粒度で比べるとき。
避ける場面
比較軸が違う情報や3案以上を無理に並べません。
基本構造
`##` 1件、箇条書き2件。各項目の先頭を太字の名称にします。
表示結果
2つの選択肢が同じ幅で並びます。

時系列 `timeline`

`timeline`は順序のある節目を左から右へ示します。

記述例
<!-- _class: content timeline -->

## 6週間の進め方

1. **1週目** 対象と判断基準を合意
2. **2〜5週目** 小さく運用して測定
3. **6週目** 継続・修正・停止を判断
向いている場面
時系列または実行順を、3段階で示すとき。
避ける場面
順序のない項目や4段階以上の詳細工程には使いません。
基本構造
`##` 1件、番号付きリスト3件。各項目の先頭を太字にします。
表示結果
3つの節目が順序付きのカードとして表示されます。

3つの柱 `pillars`

`pillars`は同じ重みを持つ3つの要素を並べます。

記述例
<!-- _class: content pillars -->

## 運用を支える3つの柱

- 入力を揃える
- 根拠を残す
- 次回も再利用する
向いている場面
同格の価値、原則、戦略の柱を3つ示すとき。
避ける場面
優先順位や前後関係がある要素には使いません。
基本構造
`##` 1件、箇条書き3件。
表示結果
3つの柱が同じ大きさで表示されます。

ビジュアル付き本文 `image`

`image`はテンプレート内蔵のビジュアル領域を右側へ確保します。

記述例
<!-- _class: content image -->

## 仕組みが、判断の時間をつくる

- 入力を集める
- 差分を見つける
- 次の行動を決める
向いている場面
選択中のデザインが持つ装飾と、短いメッセージを左右に見せるとき。
避ける場面
外部画像を読み込むclassではありません。任意画像の配置には使用できません。
基本構造
`##` 1件、短い本文または3件以内のリスト。
表示結果
本文を左へ寄せ、選択中のデザインに対応した装飾を右へ表示します。

Chart記法

`chart`ブロックへJSONを書き、数値をスライド内で可視化します。1枚につき1つのChartを配置できます。

表から作る

Editor下部のChartボタンを開き、セルを直接編集します。Excel・Google Sheets・CSVからコピーした範囲も、選択したセルを起点に貼り付けられます。

向いている場面
元データが表にあり、JSONを直接書かずにChartを作るとき。
避ける場面
機密情報を貼り付ける前に、共有範囲と出典を確認してください。
基本構造
1列目はラベル、2列目以降は系列名と数値。最大12データ行・4系列。
表示結果
表がChart JSONへ変換され、Markdownへ挿入されます。
現在の制限
入力した表は保存・送信されません。円・ドーナツグラフは1系列だけ使用できます。

棒グラフ

カテゴリー間や複数系列の数値を比較します。

記述例
```chart
{"version":1,"type":"bar","title":"四半期別ダウンロード数","labels":["Q1","Q2","Q3","Q4"],"series":[{"name":"PDF","values":[120,180,240,310]},{"name":"PowerPoint","values":[80,130,190,260]}]}
```
向いている場面
部署・商品・施策など、離散した項目の大小を比較するとき。
避ける場面
時間変化を連続した傾向として見せたい場合は折れ線を使います。
基本構造
最大12ラベル・4系列。各values数をlabels数と揃えます。
表示結果
カテゴリーごとの棒と凡例が表示されます。
現在の制限
単位と集計期間をスライド見出しまたは本文へ明記してください。

折れ線グラフ

月や四半期など、順序のある値の推移を示します。

記述例
```chart
{"version":1,"type":"line","title":"月間ユーザー数","labels":["1月","2月","3月","4月","5月"],"series":[{"name":"ユーザー","values":[120,180,260,310,420]}]}
```
向いている場面
時間経過に伴う増減、転換点、複数系列の傾向を示すとき。
避ける場面
順序のないカテゴリー比較には棒グラフを使います。
基本構造
最大12ラベル・4系列。labelsを時間順に並べます。
表示結果
値を結ぶ線、点、軸、凡例が表示されます。
現在の制限
欠損を0として扱わず、使用するデータ範囲を揃えてください。

円グラフ

全体に対する各項目の割合を示します。

記述例
```chart
{"version":1,"type":"pie","title":"テンプレート利用割合","labels":["Business","Education","Creative","Technology"],"series":[{"name":"利用数","values":[42,25,18,15]}]}
```
向いている場面
1つの全体を構成する少数項目の比率を示すとき。
避ける場面
項目が多い場合、差が小さい場合、時系列比較には使いません。
基本構造
系列は1つだけ。0以上の値を指定し、少なくとも1件を正数にします。
表示結果
各ラベルの割合が円の区画として表示されます。
現在の制限
厳密な大小比較が必要なら棒グラフを使ってください。

ドーナツグラフ

中央に余白を持たせながら構成比を示します。

記述例
```chart
{"version":1,"type":"doughnut","title":"アカウント構成","labels":["Guest","Free","Plus","Pro"],"series":[{"name":"ユーザー","values":[55,30,10,5]}]}
```
向いている場面
1つの構成比を、余白を持つ軽い見た目で示すとき。
避ける場面
複数系列や細かな差の比較には使いません。
基本構造
系列は1つだけ。0以上の値を指定し、少なくとも1件を正数にします。
表示結果
各ラベルの割合がリング状に表示されます。
現在の制限
中心へ任意テキストを置く機能は現在サポートしていません。

Mermaid記法

`mermaid`ブロックで処理、やり取り、状態、クラス、データ関係を図にします。1枚につき1つ配置できます。

フローチャート

処理や判断の流れを示します。

記述例
```mermaid
flowchart LR
A[デザイン] --> B[Markdown]
B --> C[Preview]
C --> D{修正する?}
D -->|はい| E[内容・配置を調整]
E --> C
D -->|いいえ| F{出力}
F --> G[PDF]
F --> H[PowerPoint]
F --> I[Google Slides]
```
表示結果
選択中のデザインに合わせた編集元Markdown由来の図を表示します。
現在の制限
外部リンク、click、HTML、init、任意style directiveは安全のため使用できません。

シーケンス図

登場人物やサービス間のやり取りを示します。

記述例
```mermaid
sequenceDiagram
利用者->>Marplio: Markdownを編集
Marplio-->>利用者: Previewを更新
```
表示結果
選択中のデザインに合わせた編集元Markdown由来の図を表示します。
現在の制限
外部リンク、click、HTML、init、任意style directiveは安全のため使用できません。

状態遷移図

状態の変化を示します。

記述例
```mermaid
stateDiagram-v2
[*] --> Draft
Draft --> Review
Review --> Published
```
表示結果
選択中のデザインに合わせた編集元Markdown由来の図を表示します。
現在の制限
外部リンク、click、HTML、init、任意style directiveは安全のため使用できません。

クラス図

クラスと依存関係を示します。

記述例
```mermaid
classDiagram
class Deck {
  +String title
  +export()
}
class Template
Deck --> Template : uses
```
表示結果
選択中のデザインに合わせた編集元Markdown由来の図を表示します。
現在の制限
外部リンク、click、HTML、init、任意style directiveは安全のため使用できません。

ER図

データ同士の関係を示します。

記述例
```mermaid
erDiagram
USER ||--o{ DECK : owns
DECK }o--|| TEMPLATE : uses
```
表示結果
選択中のデザインに合わせた編集元Markdown由来の図を表示します。
現在の制限
外部リンク、click、HTML、init、任意style directiveは安全のため使用できません。

現在の制限

安全性とPreview・書き出しの一致を守るための制限です。

HTMLは使用できません

表セル内の安全な改行に使う`<br>`を除き、Markdown内のHTMLタグはMarplio Engineで無効化されます。

表示結果
HTMLではなく、上記のMarkdown記法を使用してください。

外部画像は案内対象外です

外部URL画像は現在のPreviewセキュリティ設定で読み込めません。

表示結果
Previewと書き出しの動作を統一する対応が完了するまで、画像記法はサポート対象外です。

themeと16:9は自動設定されます

Marplioが選択中のデザインとスライドサイズを自動で付与します。

表示結果
front matterやtheme名をMarkdownへ書く必要はありません。