MD ViewerMD Viewer

100% プライベート — すべてブラウザ内で処理

マークダウン 番号付きリスト — 書き方とネストの例

マークダウン 番号付きリストを項目ごとに組み立てる——追加、削除、並べ替え——と、番号がライブで振り直されます。マーカー、ネスト、インデントも完備。

MD Viewer チーム

例
1.
2.
3.
1. First
2. Second
3. Third
プレビュー
  1. First
  2. Second
  3. Third

マークダウン 番号付きリストは番号順のリストです。1.、2.、3.で始まる行が、本物の番号付きの並びとして表示されます。上のプレイグラウンドはライブのリストビルダーです。各項目は入力欄で、「追加」「削除」ボタンでマークダウン 番号付きリストが伸び縮みし、プレビューが常に番号を振り直します。下では生成されたソースがリアルタイムで更新され、リストの裏にある正確なマークアップが常に見えます。

マークダウン 番号付きリストには有名な超能力があります。番号の怠惰です。すべての行を1.で始めても、ほとんどのレンダラーは1、2、3を出力します。ソースの実際の数字は、マーカーとピリオドとインデントに比べてずっと重要ではありません。だからマークダウン 番号付きリストの項目を並べ替えても、文書を手で振り直し番号するはめにならず、上のビルダーは真ん中に項目を挿入しても他に触れません。

このページは完全な解剖を扱います。1.と1)のマーカー形式、インデントの深さがネストを制御する仕組み、密なリストと疎なリストを分ける空行、そして番号を黙って壊す間違い——一貫しないインデント、混ざったマーカー。すべての主張はプレイグラウンドで検証でき、すべてはブラウザ内でローカルに動きます。

マークダウン 番号付きリストの構文リファレンス

入力レンダリング結果
1. 1つ目 2. 2つ目1と2に番号が付いたシンプルなマークダウン 番号付きリスト
1. 同じ 1. 同じ同じく1、2、3。レンダラーが振り直してくれる
1) 括弧 2) 括弧括弧マーカーも番号付きリストになる
1. 項目 1. 子1つ目の項目の中にネストされたリスト
1. A 2. B疎なリスト。空行が段落の間隔を追加

マークダウン 番号付きリストの書き方

  1. 1

    各行を数字とマーカーで始める

    1. に続けてスペース、そして項目のテキストを入力します。ページの下まで繰り返します。マークダウン 番号付きリストは1.から999999.までを受け付け、残りを正規化します。

  2. 2

    ネストには3スペース

    ネストされた項目を親のテキストの下に揃えます。1.形式のマーカーには3〜4スペースです。ネストされたマークダウン 番号付きリストは、独自の番号を持つサブリストになります。

  3. 3

    周囲のテキストから分離する

    リストの上に空行を置き、段落の続きとして解析されないようにします。リスト内では、項目間の空行がマークダウン 番号付きリストを密から疎に切り替えます。

  4. 4

    組み立ててコピー

    上の項目エディタで項目を追加・削除し、「Markdownをコピー」で生成されたマークダウン 番号付きリストのソースを持ち帰りましょう。

番号の規則と怠惰な1.のパターン

マークダウン 番号付きリストは元の仕様から1つの考え方を継承しています。最初の数字が開始値を決め、レンダラーが項目を自分で数える。すべての行が1.で始まるリストは1、2、3、4と表示されます。使ってみるまでバグに聞こえますが、使えば納得です。全項目1.のパターンでは、途中への挿入に振り直しが不要で、削除しても穴が残りません。多くの大規模ドキュメントプロジェクトがこのパターンをスタイルガイドに定めているのは、まさにこのためです。

契約書には知っておくべき条項が1つあります。ソースの数字の実際のジャンプは、最初だけ尊重されます。5.で始まるマークダウン 番号付きリストは5から数え始めますが、後の行を42.にしても何も変わりません。正確で目に見える番号が重要な場面——法務条項、契約の細項目——では、ソースの数字を信じるのではなく、レンダリング結果を確認してください。プレイグラウンドのプレビューは、組み立てたリストの振られた番号を表示します。このページが教えたい習慣です。

最後に身につけたい習慣が1つ。マークダウン 番号付きリストの各項目は構造的に並行に保つことです。1文、同じ声、同じ語頭の大文字小文字。並行な項目は目で流すのが速く、いずれリストがPDFやスライドに変わるとき、均一な項目は手直しなしでフォーマット変更を生き延びます。上のビルダーは、入力しながらそのリズムを見せてくれます。

マークダウン 番号付きリストの間違い

1. 1つ 2. 2つ 1. 3つ

1. 1つ 2. 2つ 3. 3つ

めちゃくちゃな数字でもたいてい1-2-3と表示されますが、レビュアーはソースを読みます。diffが綺麗なマークダウン 番号付きリストのために、番号を意図に揃えましょう。

1. 親 1. 子(2スペース)

1. 親 1. 子(3スペース)

2スペースは3文字の1.マーカーを越えられず、子は親の行に融合します。ネストしたマークダウン 番号付きリストには3〜4スペースが必要です。

1. 1つ目 - 2つ目

1. 1つ目 2. 2つ目

リストの途中でマーカー型を変えると新しいリストが始まり、番号が最初から振り直されます。1つのマークダウン 番号付きリストには1つのマーカースタイルを。

番号付きリストは忠実にエクスポートされる

ここで組み立てたマークダウン 番号付きリストは、マークダウン PDF 変換のページで綺麗に変換されます。本物の番号、ネストレベルの正しいインデント、そして項目と番号を決して引き離さないページ送り。

よくある質問

出典と仕様引用

“An ordered list marker is a sequence of 1-9 arabic digits (0-9), followed by either a . character or a ) character.”
CommonMark Specification 0.31.2
“Markdown is intended to be as easy-to-read and easy-to-write as is feasible.”
John Gruber, "Markdown: Syntax" (Daring Fireball, 2004)

関連するMarkdownツール