markdown

GitHub Flavored Markdown（GFM）

公式のGitHub の基本的な記述および書式設定の構文を参考にしています。

GFM は標準の Markdown を拡張したもので、イシュー、PR、ディスカッション、コメント、.md ファイル向けの GitHub 固有の拡張機能が含まれています。

---

構文の概要

機能	構文
見出し	# H1 … ###### H6
太字	**text**
斜体	_text_
取り消し線	~~text~~
リンク	[text](url)
画像	
インラインコード	`code`
コードブロック	``` lang … ```
引用	> text
順序なしリスト	- item
順序付きリスト	1. item
タスクリスト	- [ ] task / - [x] done
アラート	> [!NOTE] / [!TIP] / [!WARNING] / [!IMPORTANT] / [!CAUTION]
脚注	text[^1] … [^1]: note
メンション	@user / @org/team
イシュー参照	#42
絵文字	:tada:
エスケープ	\*literal\*
コメント

---

必要に応じて読む

読むタイミング	ファイル
GFM の各機能の構文をすぐに確認したいとき	クイックリファレンス
見出し、テキストのスタイル、コードブロック、改行、エスケープ	テキストと見出し
リンク（インライン、セクション、相対パス、カスタムアンカー）、画像	リンクと画像
順序付き／順序なしリスト、ネスト、タスクリスト	リストとタスク
アラート、脚注、メンション、絵文字	アラート、脚注、メンション

---

よくある落とし穴

• .md ファイルの改行には、末尾にスペースを2つ付けるか、\ または <br/> が必要です。通常の改行では行が折り返されません。
• 入れ子になったリストのインデントでは、子項目のマーカーが親項目の最初のテキスト文字の下に揃うようにします。
• セクションアンカーの生成：小文字に変換し、スペースは - に置き換え、それ以外の句読点はすべて削除されます。重複する見出しには -1、-2 という接尾辞が付くため、見出しの順序を変更する場合はリンクも更新してください。
• アラートはほかの要素の中に入れ子にできません。また、使用は必要最小限にしてください。
• 脚注はGitHubのWikiではサポートされていません。
• カラー見本（`#hex`, `rgb()`, `hsl()`）は、Issue、PR、ディスカッションでのみレンダリングされます。通常の .md ファイル表示ではレンダリングされません。
• カスタムアンカー（<a name="">）は、自動生成される目次に含まれません。

---

ベンチマーク

シナリオ：.benchmarks/scenarios/markdown-001-wiki-limits.md · 実行日：2026-08-31 · ログ：.benchmarks/runs/2026-08-31/markdown-001-wiki-limits.json

モデル	なし	あり	差分
claude-opus-4-8	100%	100%	+0%
claude-sonnet-4-6	100%	100%	+0%
claude-haiku-4-5	80%	100%	+20%

条件付き合格（実行日 2026-08-31）。Haikuは+20（80→100）。opus／sonnetは上限に到達。.agents/skills/skill-optimizer/rules/release-gates.md に従って判定します。