Як додати виноски до Markdown з ароматом GitHub?

Я просто намагаюся додати виноски до мого GitHub Gist , але це не працює:

Some long sentence. [^footnote]

[^footnote]: Test, [Link](https://google.com).

Я дотримуюся цього керівництва і не думаю, що роблю щось не так. Чи може хтось вказати на мою помилку?

GitHub Flavored Markdown не підтримує виноски, але ви можете вручну підробити це¹ з символами Unicode або надписними тегами, наприклад <sup>1</sup>.

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

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

<a name="myfootnote1">1</a>: Footnote content goes here

Потім посилайтеся на це в іншому місці документа, подібного до цього

<sup>[1](#myfootnote1)</sup>

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

 Bla bla <sup id="a1">[1](#f1)</sup>

Потім зсередини виноску, посилання на нього.

<b id="f1">1</b> Footnote content here. [↩](#a1)

Це додасть трохи ↩в кінці вмісту виноски, що поверне ваших читачів до рядка, що містить посилання виноски.

Я не зміг змусити працювати рішення Сурії та Маттео. Наприклад, "(# f1)" просто відображався як текст і не став посиланням. Однак їхні рішення привели мене до трохи іншого рішення. (Я також відформатував виноску та посилання на початковий надрив трохи інакше.)

В тексті тексту:

Yadda yadda<a href="#note1" id="note1ref"><sup>1</sup></a>

В кінці документа:

<a id="note1" href="#note1ref"><sup>1</sup></a>Here is the footnote text.

Клацнувши на надрисі у виносці, повертається до індексу початкового тексту.

Хоча я не знаю, чи це офіційно зафіксовано де-небудь, ви можете робити ноти колонтитулу в Github.

1. Позначте місце, куди потрібно вставити посилання нижнього колонтитулу, з номером, укладеним у квадратні дужки, тобто [1]

2. У нижній частині публікації зробіть посилання на пронумерований маркер і слідом за двокрапкою та посиланням, IE [1]: http://www.example.com/link1

І коли ви попередньо переглянете його, він буде відображатися як нумеровані посилання в тілі публікації.

Для коротких приміток надання елементу якоря атрибутом заголовка створює "підказку".

<a title="Note text goes here."><sup>n</sup></a>

В іншому випадку для більшої кількості залучених нотаток виглядає так, що найкраще робити підтримку названих посилань вручну.

Це працює для мене:

блаблабла [<sup>1</sup>](#1)блаблабла

виноски: посилання на блаблабла <a class="anchor" id="1"></a>

Я використовував варіант рішення Матео. Я використовую це у файлах Rmd, записаних у ароматизованій розмітці (gfm) для github для веб-сайту, що працює на Jekyll, але ті самі файли Rmd використовуються для створення pdfs у різних контекстах. Файли Rmd математично важкі, а математика відображається за допомогою MathJax на веб-сайті. Тому мені було потрібно рішення, яке працює з gfm, який обробляється через Jekyll, працює з pandoc-> pdflatex і сумісний з MathJax.

фрагмент з файлу Rmd (який є gfm)

Here is a paragraph with an footnote <span id="a1">[[1]](#f1)</span>.

Footnotes
=========

1. <span id="f1"></span> This is a footnote. [$\hookleftarrow$](#a1)

$\hookleftarrow$це латекс, який працює для мене, оскільки у мене завжди включений MathJax. Я використовую це, щоб переконатися, що він правильно відображається в моїх файлах pdfs. Я поміщаю виноски у квадратні дужки, тому що супріск є заплутаним, якщо я ставлю виноску на якусь вбудовану математику.

Ось це в дії: https://eeholmes.github.io/posts/2016-5-18-FI-recursion-1/

Ці замітки можна розмістити в будь-якому місці Rmd. Я вношу список в кінці, щоб вони були технічно конотаціями.

Ось варіант Eli Холмс " відповідь , який працював для мене без використання латексу:

Text<span id="a1">[¹](#1)</span>

<span id="1">¹</span> Footnote.[⏎](#a1)<br>

Приклад

Хоча питання стосується Markdown з ароматом GitHub, я думаю, варто згадати, що станом на 2013 рік GitHub підтримує AsciiDoc, який має цю функцію. Вам потрібно лише перейменувати файл із .adocрозширенням та використовувати:

A statement.footnote:[Clarification about this statement.]

A bold statement!footnote:disclaimer[Opinions are my own.]

Another bold statement.footnote:disclaimer[]

Документація разом з кінцевим результатом знаходиться тут .