Markdown リンク

リンクは、Markdown ドキュメントにインタラクティブ性を持たせるための重要な要素です。

リンク構文を習得すると、コンテンツが豊富でナビゲーションしやすいドキュメントを作成できます。

リンクの使用方法は次のとおりです:

[リンク名](リンクURL)
[リンクテキスト](リンクURL "オプションのタイトル")

または:

<リンクURL>

簡単なリンク:

这是一个链接 [サンプル](https://www.example.com)

表示結果は次のとおりです:

リンクアドレスを直接使用する:

<https://www.example.com>

表示結果は次のとおりです:

オプションのタイトルを設定:

这是一个链接 [サンプル](https://www.example.com)
欢迎访问 [GitHub](https://github.com) 官网
这是 [百度搜索](https://www.baidu.com "百度一下,你就知道")

表示結果は次のとおりです:

リンクタイトルの役割:

  • マウスをリンクに重ねるとヒント情報が表示されます
  • 検索エンジン最適化(SEO)とアクセシビリティに役立ちます
  • タイトル文字は二重引用符、単一引用符、または括弧のいずれでも使用できます

メールリンク:

markdown联系我:[发送邮件](mailto:example@email.com)
电话联系:[拨打电话](tel:+86-138-0013-8000)

参考リンク

参考式リンクはリンク定義と使用を分離し、ドキュメントをより整潔にします。長いドキュメントや同じリンクを複数回参照する必要がある場合に特に適しています。

基本構文:

markdown[链接文字][参考标签]

[参考标签]: URL "可选标题"

変数を使用してリンクを設定できます。変数の代入はドキュメントの末尾で行います:

这个链接用 1 作为网址变量 [Google][1]
这个链接用 サンプル 作为网址变量 [サンプル][サンプル]
然后在文档的结尾为变量赋值(网址)

  [1]: http://www.google.com/
  [サンプル]: http://www.example.com/

表示結果は次のとおりです:

簡略化された書き方:

参考ラベルとリンクテキストが同じ場合、2番目の角括弧を省略できます:

markdown 我喜欢使用 [GitHub][] 来管理代码。

[GitHub]: https://github.com

参考リンクの利点:

  • ドキュメント本文がよりすっきりし、長いURLで中断されない
  • リンクの一元的な管理と更新が容易になる
  • 同じリンクを繰り返し使用でき、重複した定義を避けられる
  • リンク定義はドキュメントの任意の場所に置くことができます(通常は末尾に置きます)

整理のコツ:

markdown# 学习资源推荐

## 在线教程
- [MDN Web Docs][mdn] - 权威的 Web 技术文档
- [サンプル][rnb] - 适合初学者的教程网站
- [freeCodeCamp][fcc] - 免费的编程学习平台

## 代码托管
- [GitHub][github] - 最受欢迎的代码托管服务
- [GitLab][gitlab] - 企业级的代码管理平台

<!-- 链接定义区域 -->
[mdn]: https://developer.mozilla.org/
[rnb]: https://www.example.com/
[fcc]: https://www.freecodecamp.org/
[github]: https://github.com/
[gitlab]: https://gitlab.com/

自動リンク認識

現代のMarkdownパーサーは通常、URLとメールアドレスの自動認識をサポートしています:

URLの自動認識:

markdown直接输入网址:https://www.example.com
用尖括号包围:<https://www.example.com>

メールアドレスの自動認識:

markdown联系邮箱:example@email.com
或者:<example@email.com>

注意事項:

  • 自動認識機能は特定のMarkdownパーサーに依存します
  • 互換性を確保するため、標準のリンク構文を使用することをお勧めします
  • 一部の特殊文字は自動認識に影響を与える可能性があります

アンカーリンクの使用

アンカーリンクは同じドキュメント内でのジャンプに使用され、長いドキュメントのナビゲーションに特に適しています:

見出しにジャンプ:

## 目次
- [第1章:紹介](#第1章紹介)
- [第2章:インストール](#第2章インストール)
- [第3章:使用方法](#第3章使用方法)

# 第1章:紹介
ここは紹介内容です...

# 第2章:インストール
ここはインストール説明です...

# 第3章:使用方法
ここは使用方法説明です...

アンカールール:

  • 見出しは自動的にアンカーを生成します
  • アンカー名は通常、見出しの小文字形式です
  • スペースはハイフンに置き換えられます
  • 特殊文字は削除されます

手動でアンカーを作成:

<a id="custom-anchor"></a>
## 自定义锚点位置

[跳转到自定义位置](#custom-anchor)

ページ上部に戻るリンク:

[トップに戻る](#)
その他の拡張