MD ViewerMD Viewer

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

マークダウン 水平線 — 区切り線の書き方とサンプル

ハイフン、アスタリスク、アンダースコアの3つでマークダウン 水平線が作れます。各形式をクリックして区切り線の表示をライブで確認し、必要なものをコピーできます。

MD Viewer チーム

例
Markdownソース
プレビュー

Text above the divider


Text below the divider

マークダウン 水平線(仕様上はセマティックブレイク)は、文書のセクションを分割する全幅の区切り線です。ハイフン、アスタリスク、アンダースコアを3つ以上、独立した行に置くだけで作れます。---、***、___。上のプレイグラウンドで各形式をクリックすると、左にソース、右にレンダリングされたマークダウン 水平線が即座に表示されます。

構文は単純に見えますが、2つの落とし穴が全員を捕まえます。第一に、マークダウン 水平線を置く行の前には空行が必要です。なければテキスト直下の---はそのテキストを見出しに変えてしまいます。第二に、アンダースコアの間にスペースを入れられないことです。ハイフンとアスタリスクはスペースを挟めます。プレイグラウンドの「見出しの曖昧性」の例がこの罠をライブで示すので、READMEに出荷する前に自分のファイルの中で認識できるようになります。

すべてはブラウザ内でローカルに動作します。例を編集し、区切りの上下に自分のテキストを足し、「Markdownをコピー」で動作するマークダウン 水平線をどこにでも貼り付けましょう。ツールの下には、完全な構文表、区切り線を綺麗に入れる手順、Setext見出しの罠の解説、そして水平線についてよくある質問を用意しました。

マークダウン 水平線の構文リファレンス

入力レンダリング結果
---マークダウン 水平線(セマティックブレイク)
***アスタリスクによる水平線
___アンダースコアによる水平線
- - -スペースを挟んだハイフンも区切り線になる
----------3文字を超えても同じ表示
タイトル ---区切り線ではなくH2見出しとして表示(Setext)

マークダウン 水平線の正しい挿入方法

  1. 1

    上に空行を置く

    空行がマーカーを前の段落から切り離します。なければテキスト行の下の---はマークダウン 水平線を引く代わりに、その行を見出しに再定義します。

  2. 2

    マーカーを3つ以上入力

    ---、***、___を選び、同じ文字を3回以上繰り返します。長さに関係なくマークダウン 水平線は同じ表示になり、多くのスタイルガイドはちょうど3文字に定めています。

  3. 3

    下にも空行を続ける

    区切りの後の空行は次の段落がくっつくのを防ぎ、直後のハイフンリストを曖昧さに巻き込まないようにします。マークダウン 水平線の両側の空行は保険です。

  4. 4

    プレビューしてコピー

    上のチップで3種類のマーカーを試し、「Markdownをコピー」で正確なソースを取得します。貼り付けたマークダウン 水平線はすべてのCommonMarkプラットフォームで表示されます。

Setextの罠:---がマークダウン 水平線にならないとき

段落の下では、ハイフンの行は意味が完全に変わります。Setext見出しの下線になり、上のテキストをH2に昇格させます。つまり、テキストの直後に---を置くと大きな見出しができ、テキスト・空行・---の順に置くと段落とマークダウン 水平線ができます。これが水平線をめぐる最も一般的な混乱であり、「見出しの曖昧性」の例は1行の違いで両方の結果を見せます。

同じ相互作用が、より厄介な失敗も説明します。ハイフンリストの直下の---は、レンダラーによってはリストにくっつくことがあります。両側の空行が解決策です。マークダウン 水平線が始まる前に、周囲の構成要素をすべて終わらせます。区切り線が予想外に表示されたら、まず足りない空行を疑ってください。

水平線が輝く場所も押さえておきましょう。リリースノートはバージョンごとにマークダウン 水平線を置き、v2.4を探す読者がブロックからブロックへ視覚的にジャンプできるようにします。長いガイドは付録の前に1本置き、個人メモは1つのファイルで日付やトピックを分けます。見出しがセクションを告げ、マークダウン 水平線が大きな流れを示し、余白が残りを担当する——これが構造のための区切り線の正しい使い方です。

マークダウン 水平線の間違いと修正

タイトル ---

タイトル ---

空行がないと、ハイフンがタイトルをH2見出しに変えます。空行を入れれば意図したマークダウン 水平線が戻ります。

_ _ _

___

スペースを挟んだアンダースコアは区切り線になりません。場合によってはテキストを強調します。アンダースコンは密着させて、ハイフンとアスタリスクはスペースを許します。

ハイフン2つ --

ハイフン3つ ---

マークダウン 水平線には3文字以上のマーカーが必要です。2つのハイフンはリテラルなテキストとして表示されます。

区切り線は構造のため、装飾ではない

マークダウン 水平線は大きなセクション境界——付録、変更履歴の区切り、トピック転換——を示します。すべてのサブセクションに区切り線を置く文書は散らかって読めます。まず見出しを使い、マークダウン 水平線は本当に必要な継ぎ目のために取っておいてください。

よくある質問

出典と仕様引用

“A line consisting of optionally up to three spaces of indentation, followed by a sequence of three or more matching -, _, or * characters, each followed optionally by any number of spaces or tabs, forms a thematic break.”
CommonMark Specification 0.31.2

関連するMarkdownツール