Markdownでリンクを定義して使いまわす

• February 15, 2018
• Markdown  

先日、たまたまJeninsのREADME.mdのRAWデータを見ていたら、ロゴの部分が[![][ButlerImage]][website]と書かれていました。

初めてこの書き方を見たのでちょっとびっくりしたのですが、これはURLにラベルをつけて使い回しする方法のようでした。CommonMarkにもLink reference definitionsとして記述があります。

1
2

[taikii-blog]: https://taikii.github.io
[taikii-blog] と書くとリンクになる。

taikii-blog と書くとリンクになる。

少し調べたところ、このラベル定義は実装によって癖があるようです。

• GitHub、Qiita: ラベル定義はドキュメント上のどこでもOK
• GitLab、Redmine: ラベル定義は参照箇所より上に書く必要がある

覚えておくと便利・・・いや、別に覚えなくていい気がします。使い所が謎。

2018/05/01追記

リンクになっていなかったので修正しました。