Перехресне посилання (назване якорем) у відмітці

Чи є синтаксис розмітки для еквівалента:

Take me to <a href="#pookie">pookie</a>

... 

<a name="pookie">this is pookie</a>

Take me to [pookie](#pookie)

повинен бути правильним синтаксисом розмітки, щоб перейти до точки прив’язки під назвою pookie.

Щоб вставити опорну точку цього імені, використовуйте HTML:

<a name="pookie"></a>

Маркдаун, здається, не проти, де ви поставите опорну точку. Корисне місце для його розміщення - в заголовку. Наприклад:

### <a name="tith"></a>This is the Heading

працює дуже добре. (Я б продемонстрував тут, але референт SO викреслює якір.)

Зверніть увагу на самозакриваються теги і id=протиname=

Більш рання версія цієї публікації пропонувала використовувати <a id='tith' />, використовуючи синтаксис, що закривається для XHTML, та використовувати idатрибут замість name.

XHTML дозволяє будь-якому тегу бути "порожнім" та "самозакритим". Тобто це <tag />скорочена <tag></tag>пара тегів з порожнім тілом. Більшість браузерів прийматимуть XHTML, а деякі - ні. Щоб уникнути проблем із переглядачем, закрийте тег, явно використовуючи <tag></tag>, як рекомендовано вище.

Нарешті, атрибут name=був застарілий у XHTML, тому я спочатку використовував id=, що всі визнають. Однак HTML5 тепер створює глобальну змінну в JavaScript під час використання id=, і це не обов'язково є тим, що ви хочете. Тож використання name=зараз, ймовірно, буде більш дружним.

(Завдяки Slipp Дугласа для пояснення XHTML мені, і цвяхів для вказуючи на HTML5 побічний ефект - дивіться коментарі та цвяхар «s відповідь більш докладно. , name=Здається, працює скрізь, хоча це не рекомендується в XHTML.)

На bitbucket.org рішення, яке проголосувало, не працюватиме. Натомість, використовуючи заголовки (з ##), можна посилатися на них як анкери, префіксуючи їх як # markdown-header-my-header-name, де # markdown-header - неявний префікс, згенерований рендеріром, і решта - нижній регістр заголовка заголовка з тире, що замінює пробіли.

Приклад

## My paragraph title

створить неявний якор, як цей

#markdown-header-my-paragraph-title

Вся URL-адреса перед кожним посиланням на якір є необов'язковою, тобто

[Some text](#markdown-header-my-paragraph-title)

еквівалентно

[Some text](https://bitbucket.org/some_project/some_page#markdown-header-my-paragraph-title) 

за умови, що вони знаходяться на одній сторінці.

Джерело: https://bitbucket.org/tutorials/markdowndemo/overview (відредагуйте джерело цього .md-файлу та подивіться, як зроблені якіри).

Використовуйте a name. Використання idне потрібного в HTML 5 та створить глобальні змінні у вашому JavaScript

Див. Специфікацію HTML 5, 5.9.8 Навігація до ідентифікатора фрагмента - і те, idі nameвикористовується.

Важливо знати, що більшість браузерів все ще перетворюють ідентифікатори в глобальні змінні . Ось швидкий тест . Використання nameуникає створення глобальних та будь-яких конфліктів, які можуть призвести до цього.

Приклад використання імені:

Take me to [pookie](#pookie)

І місце призначення:

### <a name="pookie"></a>Some heading

Markdown Anchor підтримує хешмарк, тому посилання на якір на сторінці просто було б[Pookie](#pookie)

Генерування якоря насправді не підтримується в Gruber Markdown, але є в інших реалізаціях, таких як Markdown Extra .

У додатку Markdown Extra ідентифікатор якоря додається до заголовка або підзаголовка {#pookie}.

Github Flavored Markdown на сторінках сховища Git (але не в Gists) автоматично генерує якір з декількома тегами розмітки у всіх заголовках (h1, h2, h3 тощо), включаючи:

• id="user-content-HEADERTEXT"
• class="anchor"
• href="#HEADERTEXT"
• aria-hidden="true" (це для піктограми посилання svg, яка відображається при переході миші)

Виключаючи значок aria / svg, коли пише:

• # Header Title

Github генерує:

• <h1><a id="user-content-header-title" class="anchor" href="#header-title">Header Title</a></h1>

Тому для створення заголовків посилань нічого не потрібно робити, і завжди можна посилатися на них за допомогою:

• Посилання на [Header Title](#header-title)

У початковому синтаксисі Markdown немає доступного синтаксису, щоб це зробити, але Markdown Extra надає можливість принаймні присвоїти ідентифікатори заголовкам - з якими потім можна легко зв’язати. Зауважте також, що ви можете використовувати звичайний HTML як у Markdown, так і в Markdown Extra, і що nameатрибут був замінений idатрибутом в останніх версіях HTML.

Для всіх, хто шукає рішення цієї проблеми в GitBook. Ось як я змусив це працювати (в GitBook). Потрібно чітко позначити заголовок, наприклад:

# My Anchored Heading {#my-anchor}

Потім посилання на цей якір, як це

[link to my anchored heading](#my-anchor)

Рішення та додаткові приклади можна знайти тут: https://seadude.gitbooks.io/learn-gitbook/

Пізно на вечірку, але я думаю, що це доповнення може бути корисним для людей, з якими працюють rmarkdown. В rmarkdownє вбудована підтримка для посилань на заголовки в документі.

Будь-який заголовок, визначений

# Header

на яку можна посилатися

get me back to that [header](#header)

Далі наведено мінімальний окремий .rmdфайл, який показує таку поведінку. Його можна в'язати до .pdfі .html.

---
title: "references in rmarkdown"
output:
  html_document: default
  pdf_document: default
---

# Header

Write some more text. Write some more text. Write some more text. Write some more text. Write some more text. Write some more text. Write some more text. Write some more text. Write some more text. Write some more text. Write some more text. 

Go back to that [header](#header).

Використовуючи останню версію Markdown, ви зможете використовувати такий синтаксис:

[](){:name='anchorName'}

Це має створити такий HTML:

<a name="anchorName"></a>

Якщо ви хочете, щоб на якорі був текст, просто додайте текст якоря в квадратні дужки:

[Some Text](){:name='anchorName'}

Для найбільш поширених генераторів розмітки. У вас є простий якісно створений якір у кожному заголовку. Наприклад, з pandoc , згенерований якір буде кулею випадку шапки вашого заголовка.

 echo "# Hello, world\!" | pandoc
 # => <h1 id="hello-world">Hello, world!</h1>

Залежно від того, який синтаксичний аналізатор ви використовуєте, якір може змінюватися (візьміть приклад символіки та відповіді La muerte Peluda, вони різні!). Дивіться цю мітку, де ви можете бачити згенеровані якіри залежно від вашої реалізації розмітки .