やあ、こんにちは。開発現場でドキュメントの山に埋もれていないかい？
「あ、今の議事録、あの人の発言をメモするのにマウスに持ち替えてしまった……」「見出しをつけるために、わざわざツールバーをクリックした……」
そんな小さな“マウスへの浮気”が、実は君の思考のフロー状態（ゾーン）をブツ切りにし、チーム全体のベロシティ（開発速度）をじわじわと削り取っているんだ。
今回は、Confluenceをただの「情報の墓場」から「爆速のナレッジ共有ハブ」へと変貌させる、マークダウン記法とキーボードショートカットの極意を伝授しよう。これをマスターすれば、毎日のドキュメント作成が驚くほど軽快になり、キーボードから一歩も手を離さずに、まるで頭の中の思考をそのまま出力するかのような高速執筆が手に入るよ。
—
なぜ、Confluenceで「マークダウン」なのか？
アジャイル開発において、ドキュメントは「美しく装飾するもの」ではなく、「今この瞬間の真実を、最速で共有するもの」だ。
マウスをカチカチ動かしてフォントサイズを変えたり、パレットから色を選んだりしている時間は、エンジニアにとって完全な無駄（ムダ）でしかない。マークダウンを使えば、構造化された美しいドキュメントを、プレーンテキストを書くようなスピードで生み出すことができる。
情報のサイロ化を防ぎ、チーム全員が「書くこと」にストレスを感じない環境を作る第一歩として、まずは基本の記法から押さえていこう。
—
1. 瞬時に構造化する：見出しとテキスト装飾
まずは文章の骨組みを作る見出しだ。Confluenceでは、テキストの先頭に特定の記号を入力してスペースを押すだけで、瞬時に見出しに変換される。
| 表現したいこと | 入力する文字（半角） | 実際の効果 |
| :— | :— | :— |
| 大見出し | `#` + スペース | ページタイトルに次ぐ大きな見出し（H1） |
| 中見出し | `
` + スペース | セクションを区切る見出し（H2） |
| 小見出し | `
` + スペース | 細かなトピックの見出し（H3） |
💡 先輩のワンポイントアドバイス
「#」を打った後にスペースを入れる、このリズムを体に覚え込ませよう。マウスに手を伸ばす必要はもうゼロだ。
—
2. 思考を整理する：リストとタスク管理
アジャイルのバックログや、スプリントのタスク出しで最も使うのがリストだ。ここでもキーボードから手を離してはいけない。
- 箇条書きリスト: `-` または “ を入力してスペース。
- 番号付きリスト: `1.` を入力してスペース。自動でインクリメント（2, 3, 4…）されていく。
- タスクリスト（チェックボックス）: `[]` または `[ ]` と入力してスペース。
- [ ] スプリントバックログの精査
- [ ] CI/CDパイプラインの脆弱性チェック
- [ ] デプロイ前レビューの完了
これだけで、クリック不要のインタラクティブなタスクリストが完成する。レビューが完了したら、そのままクリック（またはショートカット）でチェックを入れられる。最高だろう？
—
3. 技術者の魂：コードブロックと引用
コードやエラーログを共有する際、わざわざ「コードスニペット」のアイコンを探すのはもう止めよう。
コードブロックの爆速召喚
行頭で “ “（バッククォート3つ） を入力し、Enterを押すだけで、美しいシンタックスハイライト付きのコードブロックが降臨する。
チームのベロシティを高めるための基本設定例
version: ‘3.8’
services:
knowledge-base:
image: confluence:latest
ports:
- “8090:8090”
environment:
- XSRF_CHECK=enabled
言語名をバッククォートの直後（例: ）に書くのを忘れないように。これだけで可読性が劇的に跳ね上がる。
引用（blockquote）
他者の意見や、重要な注意点をハイライトしたい時は、行頭に `>` を置こう。
> 「ドキュメントは完璧を目指すな、更新頻度を目指せ。」—— 伝説のテックリード
—
4. 構造化データを制す：テーブル（表）の挿入
「表を作るのが面倒だからテキストで妥協する」——これがナレッジ共有の最大の敵だ。Confluenceでは、マークダウン風にテーブルもサクッと作れる。
`|`（パイプ）と `-`（ハイフン）を組み合わせてこう書くだけだ：
| 役割 | 担当領域 | 連絡手段 |
| :— | :— | :— |
| アジャイルコーチ | プロセス改善・ファシリテーション | Slack #agile |
| テックリード | アーキテクチャ設計・コードレビュー | Slack #dev-lead |
セル間の移動は `Tab` キー、前のセルに戻るには `Shift + Tab`、行の追加は一番右のセルで `Enter` だ。この操作感を手に覚えさせれば、Excelを開くことすらしなくなるはずだ。
—
5. 知っていると圧倒的に得する！最強ショートカット集
マークダウン記法と合わせて覚えることで、君の執筆速度を光速にするショートカットキーを厳選して紹介する。
| ショートカット（Mac / Windows） | 実行されるアクション |
| :— | :— |
| `Cmd + K` / `Ctrl + K` | リンクの挿入（URLを瞬時に貼る） |
| `Cmd + Shift + F` / `Ctrl + Shift + F` | インラインコード（`print()` などの囲み） |
| `Cmd + Z` / `Ctrl + Z` | 直前の操作の取り消し（迷ったらこれ） |
| `/` （スラッシュ） | クイック挿入メニューの呼び出し |
特に `/`（スラッシュ）コマンド は強力だ。文章の途中で `/` を押すと、画像、マクロ、絵文字、ステータスバッジなど、あらゆるパーツをインクリメンタルサーチで呼び出せる。マークダウン記法でカバーしきれないリッチな要素も、キーボードから一歩も出ずに配置できる。
—
さあ、今日から「ノー・マウス」で書こう
今回は、Confluenceにおけるマークダウン記法と、キーボード主体でドキュメントを高速執筆するコツについて解説した。
最初は「あれ、どう書くんだっけ？」と手が止まるかもしれない。でも、ほんの数日意識してコードやドキュメントを書いてみてほしい。気づいたときには、マウスに手を伸ばす自分がもどかしくなっているはずだ。
ドキュメント作成のストレスが消えれば、チームへのナレッジ共有はもっと楽しく、もっと活発になる。
これをマスターすれば、毎日の作業が劇的に楽になりますよ。さあ、今すぐ新しいページを開いて、キーボードだけで一枚書いてみよう！