AsciiDoc記法の注意点

カテゴリ
技術
タグ
AsciiDoc

すごく細かな話です。
AsciiDoc文書では、アンカーリンクで文書内のリンクを貼ることができますが、そのアンカーリンクの文言に使用できない記号があります。そういうのはたいてい半角記号だったりするのですが、 全角でもダメなものもあります。
ここで挙げる文字はリンクの文言には避けて使わなければなりません。

使えない記号群

  • 【】
  • 「」
  • ()
  • スペース

意外と使える記号

  • _
  • _

確認環境

  • Asciidoctor 2.0.9
  • Windows 10

使えない文字を使用したアンカーリンク例(リンクにならない。)

<<※使えない1>>
<<【使えない2】>>
<<「使えない3」>>
<<(使えない4)>>
[使えない:5]
[使えない 6](アンカーリンクにはなるが、リンク先のほうが上手くいっていない)
<<※使えない1>>
<<※使えない1>>
<<※使えない1>>
<<※使えない1>>

[※使えない1]
[【使えない2】]
[「使えない3」]
[(使えない4)]
[使えない:5]
[使えない 6]

使えるアンカーリンク例(リンクになる。)

view raw sample.adoc hosted with ❤ by GitHub

関連記事