Markdownハイパーリンク

リンクは、Webコンテンツの最も基本的な要素の一つです。Markdownは、シンプルなインラインリンクから、より複雑な参照スタイルのリンクまで、リンクを作成するためのいくつかの方法を提供します。

基本的なリンク構文

Markdownでのリンクの基本構文は:

[リンクテキスト](URL)

[Google](https://www.google.com)

結果: Google

タイトル付きリンク

ユーザーがマウスオーバーしたときに表示されるタイトルをリンクに追加できます:

[Google](https://www.google.com "検索エンジン")

結果: Google

参照スタイルリンク

長いドキュメントやリンクを再利用したい場合、参照スタイルリンクが非常に有用です:

これは[参照リンク][1]で、これは[別のもの][github]です。

[リンクテキスト自体]を参照として使用することもできます。

[1]: https://www.google.com
[github]: https://github.com
[リンクテキスト自体]: /

結果:

これは参照リンクで、これは別のものです。

リンクテキスト自体を参照として使用することもできます。

自動リンク

MarkdownはURLとメールアドレスを自動的にリンクにできます:

https://www.google.com
[email protected]

結果:

内部リンク

見出しへのリンク

同じドキュメント内の見出しにリンクできます:

[基本構文に移動](#基本的なリンク構文)
[例へジャンプ](#例)

見出しリンクのルール:

  • 小文字に変換
  • スペースをハイフンに置換
  • 特殊文字を削除

他のページへのリンク

[Markdownハイパーリンク](/markdown-guide/hyperlink)

結果: Markdownハイパーリンク

リンクのベストプラクティス

1. 説明的なリンクテキストを使用

❌ これはしない:

[ここ](https://example.com)をクリックして私たちのウェブサイトを訪問してください。
詳しくは[こちら](https://example.com/blog)をお読みください。

✅ 代わりにこうする:

私たちの[会社ウェブサイト](https://example.com)を訪問してください。
私たちの[最新ブログ投稿](https://example.com/blog)をお読みください。

2. リンクテキストを簡潔に保つ

❌ 長すぎる:

[たくさんの素晴らしいコンテンツがある私たちの素晴らしいウェブサイトを訪問するにはここをクリック](https://example.com)

✅ ちょうど良い:

[私たちのウェブサイトを訪問](https://example.com)

3. 可読性のために参照リンクを使用

多くのリンクがある場合、参照スタイルがコンテンツを読みやすく保ちます:

ドキュメントを書くために[Markdown][md]を使うのが大好きです。
[GitHub][gh]と[GitLab][gl]で素晴らしく動作します。
[md]: https://daringfireball.net/projects/markdown/
[gh]: https://github.com
[gl]: https://gitlab.com

特殊なリンクタイプ

メールリンク

[メールを送る](mailto:[email protected])
[件名付きメール](mailto:[email protected]?subject=こんにちは)

電話リンク

[お電話ください](tel:+1-555-123-4567)

アクセシビリティのヒント

1. 外部リンクを示す

リンクが外部サイトに移動することをユーザーに知らせる:

[Googleを訪問](https://www.google.com) (外部リンク)

2. ファイルタイプを記述

ファイルにリンクする際は、フォーマットを言及:

[レポートをダウンロード](report.pdf) (PDF、2MB)

リンクは、あなたのコンテンツをより広いWebに接続するために不可欠です。これらのテクニックをマスターして、Markdownドキュメントをより魅力的で有用にしましょう!

タスクリストの作成について学びたいですか?次にチェックボックスガイドをご覧ください。