【marp】研究発表に使いやすいテーマを作成

marpとはMarkdownという記法を用いて文書を作成するものから簡単にスライドを作成できるものである。
研究発表に使いやすいテーマを作成してみたので興味がある人は使ってみて欲しいです。

プレビュー

Marp CLI が利用できる環境では、次のコマンドで HTML を生成できます。

npx @marp-team/marp-cli example.md --theme research-plato.css --html -o example.html

VS Code の Marp 拡張では、ワークスペース設定に次を追加してください。

{
  "markdown.marp.themes": [
    "./research-plato.css"
  ],
  "markdown.marp.enableHtml": true
}

基本設定

Markdown の先頭には次の front matter を指定します。

16:9:

---
marp: true
theme: research-plato
paginate: true
size: 16:9
html: true
---

4:3 を使う場合は size だけを変更します。

---
marp: true
theme: research-plato
paginate: true
size: 4:3
html: true
---

同じ Markdown 内では全スライドが同じサイズになります。資料ごとに
size: 16:9 または size: 4:3 を選択してください。

タイトルスライドは lead クラスを指定します。

<!-- _class: lead -->

# 発表タイトル

発表者名 / 所属

二段組

均等な二段組:

<div class="columns">
<div>

左側の内容

</div>
<div>

右側の内容

</div>
</div>

左を広くする場合は columns ratio-2-1、右を広くする場合は
columns ratio-1-2 を指定します。

表

標準のMarkdown表をそのまま使えます。列の配置は区切り行のコロンで指定します。

| 手法 | 精度 | 備考 |
| :--- | ---: | :---: |
| 手法A | 89.7% | 軽量 |
| **手法B** | **92.4%** | **最良** |

• :--- は左揃え
• ---: は右揃え（数値列向け）
• :---: は中央揃え

行数が多い表では、そのスライドに <!-- _class: compact-table --> を指定すると
文字とセル余白が小さくなります。

文字色

組み込み色は text-red、text-blue、text-green、text-orange、
text-purple、text-muted です。

結果は <span class="text-red">有意</span> でした。
任意色は <span style="color: #b146c2">この色</span> のように指定します。

span で囲む範囲は一文字だけでも構いません。HTML を使うため、CLI では
--html、VS Code では markdown.marp.enableHtml が必要です。

中央揃え

一部分だけ中央揃え:

<div class="center">

中央揃えにする内容

</div>

スライド本文全体を中央揃え:

<!-- _class: center-slide -->

補足スライド

補足スライドを本編の総ページ数 N に含めない場合は、最初の補足スライドに
次のディレクティブを指定します。

---

<!-- paginate: skip -->

# 補足資料

paginate: skip は指定したスライド以降へ引き継がれます。補足資料を末尾へ
まとめて配置すれば、本編が8ページ、補足が3ページの場合でも、本編の表示は
1 / 8 から 8 / 8 のままです。補足スライドにはページ番号を表示しません。

補足内容

なぜPowerPointではなくmarp？

marpの良さは以下のようなところにある．

• 手軽に作れる
• html,cssを使える拡張性
• 生成AIと相性が良い

手軽さ

PowerPointではテキストボックスを選択して記述してフォントサイズや位置を動かして作成していく必要があるが，
marpではMarkdownにおける見出しサイズによって勝手にフォントサイズを決定して，位置も適切に設定してくれるため，やらなければいけないことはMarkdownの記法にしたがって内容を記述するだけですむ．

HTML, CSSによる拡張性

marpとして標準で備え付けられているテーマは本当に必要最低限のものであるが，
CSSを用いることによって自分でテーマを作成することができる．
また，Markdownの文中にHTMLを用いることができ，これによって文字の大きさ，色，右寄せなどを設定することができる．

生成AIと相性⭕️

marpは全てがMarkdownファイルと添付ファイルで完結するため，生成AIが出力しやすい形式であり文書のみのスライドであれば一瞬で作れてしまう．
最近のAIモデルでは画像を生成してそれを組み入れたときにスライドの見た目がどうなるかまで確認してくれるため，画像入りのスライドでもかなり精度良く作ることができる．

marpの向き不向き

クリエイティブなことをする人には向いていない！
決められたスタイルに従って作成したい人に向いている！

marpではPowerPointのように，気軽に文字や画像等を動かすことができないため，細かい位置の調整をしたいものや図形をその場で作りたい場合などよりクリエイティブなことをするのには向いていない．
逆に決められたスタイルに縛られた状態でスライドを作成したい場合にはmarpが適切にフォントサイズや位置を設定してくれるためPowerPointよりも必要な操作が少ない．