Как лучше всего указать в Markdown ссылку на фрагмент страницы, например #some_id?

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

<div id="mylink" /> 

а для ссылки сделайте:

[My link](#mylink)

Но я предполагаю, что есть другой способ сделать ссылку на странице в Markdown, который не включает прямой divтег.

Любые идеи?

Смотрите этот ответ .

Таким образом, сделайте пункт назначения с

<a name="sometext"></a>

вставлен в любом месте вашей разметки (например, в заголовок:

## heading<a name="headin"></a>

и ссылку на него с помощью уценки:

[This is the link text](#headin)

или

[some text](#sometext)

Не используйте <div>- это испортит макет для многих рендереров.

(Я изменил id=на name=выше. См. Этот ответ для утомительного объяснения.)

Я думаю, это зависит от того, что вы используете для создания HTML из вашей уценки. Я заметил, что jekyll (по умолчанию он используется страницами gihub.io) автоматически добавляет атрибут id = "" к заголовкам в создаваемом html.

Например, если у вас уценка

My header
---------

В результате html будет выглядеть так:

<h2 id="my-header">My header</h2>

Так что вы можете ссылаться на него просто [My link](#my-header)

В PHP-версии Markdown вы также можете связывать заголовки с идентификаторами фрагментов на странице, используя синтаксис, подобный любому из следующих, как описано здесь.

Header 1            {#header1}
========

## Header 2 ##      {#header2}

а потом

[Link back to header 1](#header1)
[Link back to header 2](#header2)

К сожалению, этот синтаксис в настоящее время поддерживается только для заголовков, но, по крайней мере, он может быть полезен для построения оглавления.

Якорь назначения для ссылки на странице HTML может быть любым элементом с idатрибутом. См. Ссылки на сайте W3C. Вот цитата из соответствующего раздела:

Якоря назначения в HTML-документах могут быть указаны либо элементом A (присвоив ему имя с атрибутом name), либо любым другим элементом (назвав его атрибутом id).

Markdown обрабатывает HTML как HTML (см. Встроенный HTML ), поэтому вы можете создавать идентификаторы фрагментов из любого элемента, который вам нравится. Если, например, вы хотите создать ссылку на абзац, просто оберните абзац тегом абзаца и включите идентификатор:

<p id="mylink">Lorem ipsum dolor sit amet...</p>

Затем используйте свой стандартный Markdown, [My link](#mylink)чтобы создать ссылку на привязку фрагмента. Это поможет сохранить ваш HTML в чистоте, поскольку нет необходимости в дополнительной разметке.

Любой, кто использует Visual Studio Team Foundation Server (TFS) 2015, действительно не любит встроенные элементы <a>или <div>элементы, по крайней мере, в заголовках. Также ему не нравятся эмодзи в заголовках:

### 🔧 Configuration 🔧

Lorem ipsum problem fixem.

Переводится на:

<h3 id="-configuration-">🔧 Configuration 🔧</h3>
<p>Lorem ipsum problem fixem.</p>

И поэтому ссылки должны либо использовать это id(что нарушает это и другие расширения предварительного просмотра в Visual Studio), либо удалять эмодзи:

Here's [how to setup](#-configuration-) //🔧 Configuration 🔧
Here's [how to setup](#configuration) //Configuration

Где последняя версия работает как онлайн в TFS, так и в предварительной версии Visual Studio с уценкой.