Libx CommonMark 基礎と葉ブロック

    このページの内容

    リンク参照定義は、任意で最大3個のスペースによる字下げを前に置いたリンクラベル、コロン（:）、任意のスペースやタブ（最大1つの行末を含む）、リンク先、任意のスペースやタブ（最大1つの行末を含む）、任意のリンクタイトルからなります。タイトルがある場合は、リンク先とスペースやタブで区切らなければなりません。それ以外の文字を続けることはできません。

    リンク参照定義は、文書の構造要素に対応するものではありません。文書の別の場所にある参照リンクや、参照形式の画像で使えるラベルを定義します。リンク参照定義は、それを使うリンクの前にも後にも置けます。

    例192 
    [foo]: /url "title"

[foo]

    <p><a href="/url" title="title">foo</a></p>
    例193 
       [foo]: 
      /url  
           'the title'  

[foo]

    <p><a href="/url" title="the title">foo</a></p>
    例194 
    [Foo*bar\]]:my_(url) 'title (with parens)'

[Foo*bar\]]

    <p><a href="my_(url)" title="title (with parens)">Foo*bar]</a></p>
    例195 
    [Foo bar]:
<my url>
'title'

[Foo bar]

    <p><a href="my%20url" title="title">Foo bar</a></p>

    タイトルは、複数行にまたがっていてもかまいません。

    例196 
    [foo]: /url '
title
line1
line2
'

[foo]

    <p><a href="/url" title="
title
line1
line2
">foo</a></p>

    ただし、空行を含めることはできません。

    例197 
    [foo]: /url 'title

with blank line'

[foo]

    <p>[foo]: /url 'title</p>
<p>with blank line'</p>
<p>[foo]</p>

    タイトルは省略できます。

    例198 
    [foo]:
/url

[foo]

    <p><a href="/url">foo</a></p>

    リンク先は省略できません。

    例199 
    [foo]:

[foo]

    <p>[foo]:</p>
<p>[foo]</p>

    ただし、山括弧を使って空のリンク先を指定することはできます。

    例200 
    [foo]: <>

[foo]

    <p><a href="">foo</a></p>

    タイトルは、リンク先とスペースやタブで区切らなければなりません。

    例201 
    [foo]: <bar>(baz)

[foo]

    <p>[foo]: <bar>(baz)</p>
<p>[foo]</p>

    タイトルとリンク先の両方に、バックスラッシュによるエスケープと、文字どおりのバックスラッシュを含められます。

    例202 
    [foo]: /url\bar\*baz "foo\"bar\baz"

[foo]

    <p><a href="/url%5Cbar*baz" title="foo&quot;bar\baz">foo</a></p>

    リンクは、対応する定義の前に置けます。

    例203 
    [foo]

[foo]: url

    <p><a href="url">foo</a></p>

    一致する定義が複数ある場合、最初の定義が優先されます。

    例204 
    [foo]

[foo]: first
[foo]: second

    <p><a href="first">foo</a></p>

    リンクの節で述べたとおり、ラベルの照合では大文字と小文字を区別しません（照合を参照してください）。

    例205 
    [FOO]: /url

[Foo]

    <p><a href="/url">Foo</a></p>
    例206 
    [ΑΓΩ]: /φου

[αγω]

    <p><a href="/%CF%86%CE%BF%CF%85">αγω</a></p>

    ある内容がリンク参照定義であるかどうかは、そこで定義したリンク参照が文書内で使われているかどうかとは無関係です。したがって、たとえば次の文書にはリンク参照定義だけが含まれ、表示される内容はありません。

    例207 
    [foo]: /url

    もう1つの例です。

    例208 
    [
foo
]: /url
bar

    <p>bar</p>

    タイトルの後にスペースとタブ以外の文字があるため、これはリンク参照定義ではありません。

    例209 
    [foo]: /url "title" ok

    <p>[foo]: /url &quot;title&quot; ok</p>

    これはリンク参照定義ですが、タイトルはありません。

    例210 
    [foo]: /url
"title" ok

    <p>&quot;title&quot; ok</p>

    4個のスペースで字下げされているため、これはリンク参照定義ではありません。

    例211 
        [foo]: /url "title"

[foo]

    <pre><code>[foo]: /url &quot;title&quot;
</code></pre>
<p>[foo]</p>

    コードブロックの内部にあるため、これはリンク参照定義ではありません。

    例212 
    ```
[foo]: /url
```

[foo]

    <pre><code>[foo]: /url
</code></pre>
<p>[foo]</p>

    リンク参照定義は、段落を中断できません。

    例213 
    Foo
[bar]: /baz

[bar]

    <p>Foo
[bar]: /baz</p>
<p>[bar]</p>

    ただし、見出しや主題区切りなど、ほかのブロック要素の直後には置けます。また、後ろに空行を置く必要はありません。

    例214 
    # [Foo]
[foo]: /url
> bar

    <h1><a href="/url">Foo</a></h1>
<blockquote>
<p>bar</p>
</blockquote>
    例215 
    [foo]: /url
bar
===
[foo]

    <h1>bar</h1>
<p><a href="/url">foo</a></p>
    例216 
    [foo]: /url
===
[foo]

    <p>===
<a href="/url">foo</a></p>

    複数のリンク参照定義を、間に空行を置かず、続けて置けます。

    例217 
    [foo]: /foo-url "foo"
[bar]: /bar-url
  "bar"
[baz]: /baz-url

[foo],
[bar],
[baz]

    <p><a href="/foo-url" title="foo">foo</a>,
<a href="/bar-url" title="bar">bar</a>,
<a href="/baz-url">baz</a></p>

    リンク参照定義は、リストやブロック引用などのブロックコンテナの内部にも置けます。定義は、そのコンテナの内部だけでなく、文書全体に作用します。

    例218 
    [foo]

> [foo]: /url

    <p><a href="/url">foo</a></p>
<blockquote>
</blockquote>