Markdown でよくある失敗

Markdown が思いどおりに変換されないときは、たいていいくつかのよくある失敗が原因です。原因が分かれば、ほとんどは一行で解決できます。

最も多い失敗は、記号と文字の間の空白です。見出しは # と文字の間に空白が必要で（#見出し ✗ / # 見出し ✓）、リストも - と文字の間に空白が必要です。また、見出し・リスト・引用・コードブロックのような要素の上下には空行を置くのが安全です。

改行もよく混乱します。Markdown では一度のエンターでは行が分かれません。行を変えるには行末に半角スペース 2 つを入れ、段落を分けるには空行を 1 つ入れます。

特殊文字が書式と誤認される場合は、前にバックスラッシュ（\）を付けてエスケープしてください。表やチェックリストが表示されないときは、対象のプラットフォームが GFM に対応しているか確認し、迷ったときは AG MD に貼り付けて実際の変換結果を自分の目で確かめましょう。