Ссылки Markdown

Ссылки — ключевые элементы, которые делают документы Markdown интерактивными.

Владение синтаксисом ссылок позволяет создавать богатые и удобные для навигации документы.

Использование ссылок выглядит следующим образом:

[link name](link URL)
[link text](link URL "optional title")

Или:

<link URL>

Простая ссылка:

这是一个链接 [Example](https://www.example.com)

Результат отображается следующим образом:

Использование адреса ссылки напрямую:

<https://www.example.com>

Результат отображается следующим образом:

Установка необязательного заголовка:

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

Результат отображается следующим образом:

Назначение заголовка ссылки:

  • Отображает информацию всплывающей подсказки при наведении мыши на ссылку
  • Полезно для поисковой оптимизации и доступности
  • Текст заголовка можно заключать в двойные кавычки, одинарные кавычки или круглые скобки

Ссылка на электронную почту:

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

Ссылки

Ссылки в справочном стиле отделяют определение ссылки от её использования, делая документы чище, и особенно подходят для длинных документов или ситуаций, когда на одну и ту же ссылку нужно ссылаться несколько раз.

Базовый синтаксис:

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

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

Мы можем задать ссылку через переменную, при этом присваивание переменной выполняется в конце документа:

这个链接用 1 作为网址变量 [Google][1]
这个链接用 example 作为网址变量 [Example][example]
然后在文档的结尾为变量赋值（网址）

  [1]: http://www.google.com/
  [example]: http://www.example.com/

Результат отображается следующим образом:

Упрощённый синтаксис:

Когда метка ссылки совпадает с текстом ссылки, вторые квадратные скобки можно опустить:

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

[GitHub]: https://github.com

Преимущества ссылок в справочном стиле:

  • Тело документа становится чище и не прерывается длинными URL
  • Упрощает централизованное управление и обновление ссылок
  • Одну и ту же ссылку можно использовать повторно, избегая дублирования определений
  • Определения ссылок можно размещать в любом месте документа (обычно в конце)

Советы по организации:

markdown# 学习资源推荐

## 在线教程
- [MDN Web Docs][mdn] - 权威的 Web 技术文档
- [EXAMPLE][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联系邮箱：[email protected]
或者：<[email protected]>

Примечания:

  • Функция автоматического распознавания зависит от конкретного парсера Markdown
  • Для обеспечения совместимости рекомендуется использовать стандартный синтаксис ссылок
  • Некоторые специальные символы могут повлиять на автоматическое распознавание

Использование якорных ссылок

Якорные ссылки используются для перехода внутри одного документа и особенно подходят для навигации в длинных документах:

Перейти к заголовку:

## Table of Contents
- [Chapter 1: Introduction](#第一章介绍)
- [Chapter 2: Installation](#第二章安装)
- [Chapter 3: Usage](#第三章使用方法)

# Chapter 1: Introduction
This is the introduction content...

# Chapter 2: Installation
These are the installation instructions...

# Chapter 3: Usage
These are the usage instructions...

Правила якорей:

  • Заголовки автоматически создают якоря
  • Имя якоря обычно представляет собой форму заголовка в нижнем регистре
  • Пробелы заменяются дефисами
  • Специальные символы удалены

Ручное создание якорей:

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

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

Ссылка возврата наверх:

[Back to top](#)
Другие расширения