デッキを作成する

デッキは src/content/decks/ の下にあるフォルダです。スライドは番号付きのファイルで、ファイル名順に並びます。

CLI で雛形を作る

bunx create-astlide deck my-talk --theme dark --format mdx   # or md | html

手動で作る

src/content/decks/my-talk/_config.json を追加します。

{
  "title": "My Talk",
  "author": "Your Name",
  "date": "2025-01-15",
  "theme": "default"
}

スライドを番号付きのファイルとして追加します。.mdx、.md、.html は混在させられます。
```
src/content/decks/my-talk/
├── _config.json
├── 01-cover.mdx
├── 02-intro.md
└── 03-demo.html
```

URL のスライド番号（/my-talk/2）は、ソートしたファイルの順番に対応します。

スライドの形式

.mdx — Markdown にコンポーネント（<Fragment>、<Columns>、<SpeakerNotes> など）を組み合わせられます。Astlide のコンポーネントは import せずに使えます。
.md — 素の Markdown です。コードのハイライトや図も使えます。
.html — 単体で完結した HTML のスライドです。body の中身がそのまま描画され、インラインの <style> も効きます（MDX と同じく、書いた内容をそのまま信頼して表示します）。手で書いた HTML や AI が生成した HTML を貼り付けるのに向いています。

---
slideLayout: cover
background: "#0b132b"
---
<style>.hero { font-size: 3rem; }</style>
<h1 class="hero">Everything in one HTML file</h1>

frontmatter

---
slideLayout: default
transition: fade
title: "Optional — used by the go-to-slide dialog"
background: "#1e293b"
class: "text-light"
notes: "Speaker notes shown in presenter / notes mode"
hidden: false
---

すべてのフィールドは frontmatter リファレンスを、組み込みの slideLayout の値はレイアウトを参照してください。

スピーカーノート

ノートは聴衆には表示されず、発表者ウィンドウ（p）とノートのオーバーレイ（n）に表示されます。スライドに合わせて、次のいずれかの方法で書けます。

<SpeakerNotes> — .mdx のスライドで、Markdown をフルに使えます。

# My Slide

Content here.

<SpeakerNotes>
Key points to mention:
- **First** important thing
- Second point with `code`
</SpeakerNotes>

スライド末尾のコメント — Slidev や Marp と同じ書き方です。.md、.mdx、.html のスライドで使え、Markdown も書けます。
```
# My Slide

Content here.


```
ノートになるのは、スライドの最後にあるコメントだけです。それ以外の場所にあるコメントは、ふつうのコメントとして扱われます。なお .mdx では HTML コメントそのものが使えないので、ふつうのコメントには {/* … */} を使ってください。
frontmatter — 短い一文なら notes: "…" で書けます。

1 枚のスライドに複数の書き方が含まれている場合は、<SpeakerNotes>、frontmatter の notes、末尾のコメントの順に優先されます。<Notes> も <SpeakerNotes> の別名として引き続き使えます。

ブラウザで編集する

astro dev の実行中にスライドで e を押すと、スライドの横にパネルが開いてソースファイルを直接編集できます。入力を止めて少し経つと（または Cmd/Ctrl+S を押すとすぐに）変更が保存され、スライドがページを再読み込みせずにその場で更新されます。変更した部分だけが差し替わるので、画面はちらつきません。カーソルの位置、フラグメントの現在のステップ、描画済みの図、カメラや録画の状態もそのまま残ります。Esc（または ✕）で保存してパネルを閉じます。

スピーカーノートの変更も同じように反映されます。frontmatter の notes でも <Notes> でも、ノートのオーバーレイと、同じスライドを表示しているほかのウィンドウ（発表者ウィンドウなど）がその場で更新されます。

スライドファイルの追加・削除・名前の変更もその場で反映されます。デッキを開いているすべてのウィンドウでスライド数とアウトラインが更新され、表示中のスライドとステップはそのまま保たれます（スライド番号は変わることがあります）。表示中のスライドのファイルが削除された場合は、その位置に来たスライドが表示されます。

パネルはスライドを移動しても開いたままで、各スライドのソースに切り替わります。

開発サーバー専用です。本番ビルドにはエディターもそのエンドポイントも含まれません。
編集できるのはスライドファイル（src/ 以下の .mdx、.md、.html）だけです。書き込みは開発サーバー自身のページからのものに限られます。
編集内容は、入力したそばからファイルに保存されます。元に戻すときは、パネルの取り消し機能か Git などのバージョン管理を使ってください。

非表示のスライド

hidden: true を指定したスライドは、開発中は表示されますが本番ビルドではスキップされます。← / →、Home / End、ツールバー、発表者ウィンドウの次スライドのプレビュー、一覧表示、移動ダイアログのいずれでも飛ばされます。直接リンクを開いた場合は、次に表示されるスライドへリダイレクトされます。