web-dev-qa-db-ja.com

GitHub風のMarkdownに脚注を追加する方法

私は 私のGitHub Gist に脚注を追加しようとしていますが、うまくいきません。

Some long sentence. [^footnote]

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

私はフォローしています このガイド そして私は何か悪いことをしているとは思いません。誰かが私の間違いを指摘できますか？

markdowngithub-flavored-markdownmultimarkdown
216
Enrico Susatyo

GitHub Flavored Markdownは脚注をサポートしていませんが、Unicode文字や上付きタグを使って手動で偽造することができます。 <sup>1</sup>。

¹脚注の番号付けを管理する責任があるため、これは理想的ではありません。あなたが1つか2つしか持っていなくても、それはかなりうまくいきます。

171
Chris

前回の回答を少し拡張して、ここで脚注リンクをクリック可能にすることもできます。最初にこのように一番下の脚注を定義します

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

それから、このようなドキュメントの他の場所でそれを参照してください。

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

前述の答えをさらに拡張して、脚注のリンクにid属性を追加できます。

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

それから脚注の中から、それに戻ってリンクしてください。

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

これにより、脚注の内容の最後に小さな↩が追加され、読者は脚注のリンクを含む行に戻ります。

144
Matteo

正式に文書化されているかどうかはわかりませんが、Githubでフッターを作成できます。

  1. フッターリンクを挿入する場所に角かっこで囲まれた番号を付けます。 [1]

  2. 投稿の一番下に、番号の付いたマーカーを参照し、その後にコロンとリンクを続けます。 [1]: http://www.example.com/link1

プレビューすると、投稿の本文に番号付きリンクとして表示されます。

11
Devy

SuryaとMatteoのソリューションをうまく動かすことができませんでした。たとえば、 "（＃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.

脚注の上付き文字をクリックすると、元のテキストの上付き文字に戻ります。

7
Mars

簡単に説明すると、title属性を持つアンカー要素を指定すると、「ツールチップ」が作成されます。

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

さもなければ、より複雑なメモのために、あなたの最善の策は手動で名前付きリンクを維持することであるように見えます。

6
Rich Traube

私はMateoのソリューションの変形を使いました。私はJekyllを使ったウェブサイトのためにgithub風味マークダウン（gfm）で書かれたRmdファイルでこれを使っていますが、同じRmdファイルがさまざまな文脈でpdfsを生成するために使われています。 Rmdファイルは数学的に重く、数学はWebサイトのMathJaxで表示されます。そのため、Jekyllを介して処理され、pandoc-> pdflatexで機能し、MathJaxと互換性のあるgfmで機能するソリューションが必要でした。

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)

私はいつもMathJaxを有効にしているので$\hookleftarrow$はラテックスです。私はそれが私のpdfに正しく現れることを確認するためにそれを使います。私が脚注を角括弧で囲んだのは、インライン数学に脚注を付けていると上付き文字が混乱しやすいからです。

ここでそれは行動中です： https://eeholmes.github.io/posts/2016-5-18-FI-recursion-1/

これらのメモはRmdのどこにでも置くことができます。最後にリストを入れているので、それらは技術的には文末脚注です。

3
Eli Holmes

これは私のために働く：

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

脚注：blablablaへの参照<a class="anchor" id="1"></a>

2
aerijman