Markdownのリンク
リンクの文字を角括弧に、URLを丸括弧に書きます：[文字](https://example.com)。いろいろなリンクの書き方、見出しやファイルへのリンク、チャットツールでの扱いを説明します。
要点
Markdownでリンクを作るには？
角括弧にリンクの文字を書き、すぐ後の丸括弧にURLを書きます。間に空白は入れません：[例](https://example.com)。URLのあとに引用符でタイトルを書くとマウスを重ねたときに表示され、URLを山括弧で囲む <https://example.com> とURLそのものがリンクになります。
Markdown
[サンプルサイト](https://example.com)
<https://example.com>リンクの書き方と例
どの書き方も普通の <a> リンクになります。違いはURLの書き方です。
タイトル付きのリンク
URLのあとの引用符の中がリンクのタイトルになり、マウスを重ねるとブラウザが表示します。
Markdown
[サンプルサイト](https://example.com "マウスを重ねると表示")表示結果
自動リンク
山括弧で囲んだURLは、そのURL自体へのリンクになります。GitHub Flavored Markdownでは、https:// や www. で始まるURLと、山括弧で囲んだメールアドレスもリンクになります。
Markdown
<https://example.com>
https://example.com
<[email protected]>参照リンク
URLにラベルを付けて、文書のどこかで定義します。長いURLで段落が読みにくくならず、複数のリンクで同じURLを使えます。
見出しへのリンク
# と見出しのIDを書きます。多くのレンダラーは、見出しの文字を小文字にして空白をハイフンに変えたものをIDにします。日本語の見出しは日本語のまま使えます。
Markdown
[インストール手順へ](#インストール手順)表示結果
空白や括弧を含むURL
空白を含むURLは山括弧で囲みます。対になった丸括弧はそのまま書けます。
画像のリンク
リンクの文字の位置に画像を書くと、画像をクリックできるようになります。READMEのバッジはこの書き方です。
Markdown
[](https://example.com/docs)表示結果
各サービスでの対応状況
[文字](URL) はほぼどこでも使えます。例外はチャットツールです。
| サービス | 対応 | 補足 |
|---|---|---|
| GitHub / GitLab | 対応 | すべての書き方に対応し、URLだけでもリンクになり、見出しにはリンク用のIDが付きます。 |
| Discord | 違いあり | メッセージで [文字](https://…) が使え、URLだけでもリンクになります。 |
| Slack | 違いあり | 環境設定の詳細設定で「Format messages with markup」をオンにすると [文字](URL) が使えます。オフのときはリンクのボタンで追加します。 |
| Obsidian | 対応 | Markdownのリンクに加え、[[ノート名]] でほかのノートにリンクできます。 |
| Qiita / Zenn | 対応 | どちらもすべての書き方に対応しています。 |
よくある質問
Markdownのリンクが効かないのはなぜですか？
] と ( の間に空白がないか、URLに空白が含まれていないか（< > で囲みます）、https:// が抜けていないかを確認します。抜けていると、URLは今のサイト内のパスとして扱われます。同じページの見出しにリンクするには？
# と見出しのIDを書きます：[インストール](#インストール)。GitHubでは見出しの文字を小文字にし、空白をハイフンに変え、ほとんどの記号を除いたものがIDになります。Discordでリンクを貼るには？
メッセージに
[文字](https://example.com) と書くと、文字がリンクとして表示されます。リンクを新しいタブで開くようにできますか？
Markdownにはその記法がありません。HTMLが使える環境では
<a href="https://example.com" target="_blank">文字</a> と書きます。HTMLを整理するサイトでは target が取り除かれることがあります。インラインリンクと参照リンクの違いは？
インラインリンクは文字のすぐ後にURLを書きます。参照リンクは短いラベルを使ってURLを別の場所にまとめるため、段落に長いURLが入らず、複数のリンクで同じURLを使えます。
別のMarkdownファイルにリンクするには？
相対パスを使います：
[ガイド](docs/guide.md)。GitHubや多くのサイトジェネレーターでは、そのファイルのページが開きます。メールアドレスのリンクを作るには？
アドレスを山括弧で囲むか（
<[email protected]>）、[お問い合わせ](mailto:[email protected]) と書きます。リンクにせずに角括弧を表示するには？
開き角括弧の前にバックスラッシュを付けます：
\[リンクではない](https://example.com)。