意外と知られてないっぽいMarkDownのリンクの書き方

More than 5 years have passed since last update.

ブログに書いたけどやっぱりこっちの方が書きやすいしこっちに書くべき事なのでこっちにも。



一般的な記法

Qiitalistの皆さんなら次のようなMarkDownが一般的では無いでしょうか。

[たいとる](url)

先に文章を書いて囲ってやればいいだけで楽ですね。


問題点

しかし、



  • 本文中にURLが大量に含まれ たり、


  • 同じリンクを何回も貼っ たり

する時にはこれは結構煩わしいことになるかと思います。


解決策(今回のメイン)

実はMarkDownではこんな記法が使えます。


[タイトル][1]

[1]:url


とてもスマートになりました!

本文中に[hoge][1]でマーク、本文の後にでも[1]:http://~のように定義してやればちゃんとリンクになります。

もちろん一度指定した名前は使い回し可能。

これは使うしか無いでしょ!



追記


タイトル(htmlのtitle属性)も付けられる


[1]: url "タイトル"


[foo]: http://example.com/ "Optional Title Here"

[foo]: http://example.com/ 'Optional Title Here'

[foo]: http://example.com/ (Optional Title Here)




idは省略出来る


[google][]

[google]: url "タイトル"



画像にも使える


![image][]

[image]: 画像URL "画像タイトル"


多分IDでも。


![がぞー][5]

[5]: 画像URL "画像タイトル"


詳しくはコメント欄で。@ngyukiさん、ありがとうございます。

http://daringfireball.net/projects/markdown/syntax

↑ここに書いてるマークアップ全てが使えるわけでは無いけど(Qiitaの独自仕様等)分かりやすい!


なお、例で引用を使ってるのはエスケープがうまくいかなかった為。 この提案をしてくれた@asahina_devさんナイス!

ちなみに引用内で使用してるidを定義しちゃうとやっぱりこれは普通の引用内のリンクになっちゃいます。

他の方法がもしなんかあったり日本語おかしい所とかも編集リクエスト、コメント大歓迎です。()