Как сделать ссылку на часть того же документа в Markdown? - PullRequest
398 голосов
/ 12 мая 2010

Я пишу большой документ Markdown и хотел бы в начале поместить оглавление, в котором будут ссылки на различные места в документе. Как я могу это сделать?

Я пытался использовать

[a link](# MyTitle)

, где MyTitle - заголовок в документе, и это не сработало.

Ответы [ 12 ]

0 голосов
/ 28 июня 2019

Некоторые дополнительные вещи, которые следует иметь в виду, если вы когда-нибудь получите необычные с символами в заголовках, к которым вы хотите перейти ...

# What this is about


------


#### Table of Contents


- [About](#what-this-is-about)

- [⚡ Sunopsis](#9889-tldr)

- [:gear: Grinders](#it-grinds-my-gears)

- [Attribution]


------


## ⚡ TLDR


Words for those short on time or attention.


___


## It Grinds my :gear:s


Here _`:gear:`_ is not something like ⚙ or ⛭


___


## ⛤ Attribution


Probably to much time at a keyboard



[Attribution]: #9956-attribution

... такие вещи, как #, ;, & и : внутри строк заголовка, обычно игнорируются / чередуются вместо экранирования, и также можно использовать стиль цитата ссылки для быстрого использования.

Примечания

GitHub поддерживает синтаксис :word: в коммитах, файлах readme и т. Д., См. gist (из rxaviers), если использование там представляет интерес.

И почти везде можно использовать десятичный или шестнадцатеричный код для современных браузеров; Шпаргалка от w3schools удобна для , особенно если вы используете CSS ::before или ::after псевдоэлементы с символами для вашего стиля.

Бонусные баллы?

На всякий случай, если кому-то интересно, как изображения и другие ссылки внутри заголовка разбираются в id ...

- [Imaged](#alt-textbadge__examplehttpsexamplecom-to-somewhere)


## [![Alt Text][badge__example]](https://example.com) To Somewhere


[badge__example]:
  https://img.shields.io/badge/Left-Right-success.svg?labelColor=brown&logo=stackexchange
  "Eeak a mouse!"
0 голосов
/ 31 июля 2018

Еще несколько вращений на трюке <a name="">:

<a id="a-link"></a> Title
------

#### <a id="a-link"></a> Title (when you wanna control the h{N} with #'s)
...