基本記法

Markdown はプレーンテキストで構造を書く記法です。下表はよく使う記法の早見表です。

Markdown 基本記法
分類 書き方 意味・結果 備考
見出し # ~ ###### ## 見出し2 見出しレベル1〜6 行頭の # の数がレベル
段落 (空行で区切る) 文章A\n\n文章B 段落が分かれる 改行1つだけでは段落にならない処理系が多い
強調(太字) **テキスト** または __テキスト__ **太字** 太字 インライン
強調(斜体) *テキスト* または _テキスト_ *斜体* 斜体 ネスト可
太字+斜体 ***テキスト*** ***強調*** 太字かつ斜体
打ち消し線 ~~テキスト~~ ~~削除~~ 取り消し線 GFM
インラインコード `code` `npm install` 等幅のコード バッククォート
リンク [表示](URL) [USB-IF](https://www.usb.org/) ハイパーリンク [表示](URL "タイトル") も可
画像 ![代替文字](URL) ![logo](./logo.png) 画像埋め込み 代替文字はアクセシビリティ用
引用 > テキスト > 引用文 引用ブロック 入れ子は >>
水平線 --- または *** または ___ --- 区切り線 前後に空行を置くと安全
強制改行 行末スペース2つ + 改行 行A␠␠\n行B 同一段落内改行 または処理系により \\ 改行

リスト

リスト記法
分類 書き方 意味・結果 備考
箇条書き - / * / + - 項目A 順序なしリスト ネストはインデント
番号付き 1. 2. 3. 1. 手順 順序付きリスト 番号は自動採番される処理系が多い
タスクリスト - [ ] / - [x] - [x] 完了 チェックボックス GFM

コードブロック・表・その他

拡張・その他
分類 書き方 意味・結果 備考
コードブロック ```言語\n...\n``` ```js\nconsole.log(1)\n``` 複数行コード + 強調表示 言語名は任意(fence)
インデントコード 行頭スペース4つ code コードブロック fence の方が一般的
表(GFM) |列|列| と |---|---| |A|B|\n|-|-|\n|1|2| :- / -: / :-: で配置
脚注 [^1] と [^1]: 説明 注釈[^1] 脚注 処理系依存
自動リンク <https://...> <https://example.com> URLリンク CommonMark
エスケープ \\文字 \\*強調しない\\* 記号を文字として表示 *, _, `, [, など
HTML混在 HTMLタグ <br> 生HTML 許可範囲は処理系・サニタイズ次第

参考リンク