マークダウンの相互参照（名前付きアンカー）

同等のマークダウン構文はありますか：

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>

Markdownはアンカーポイントをどこに置くかを気にしていないようです。ヘッダーに入れると便利です。例えば：

### <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の副作用を指摘して-コメントと見釘打機の答えを詳細については。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ファイルのソースを編集して、アンカーの作成方法を確認してください）。

を使用しnameます。idHTML 5ではを使用する必要はなく、JavaScriptでグローバル変数を作成します

HTML 5仕様の5.9.8フラグメント識別子への移動 -との両方idをname使用するを参照してください。

ほとんどのブラウザがIDをグローバル変数に変換することを知っておくことは重要です。こちらが簡単なテストです。name回避策を使用すると、グローバルの作成と、発生する可能性のある競合を回避できます。

名前を使用した例：

Take me to [pookie](#pookie)

そして、宛先アンカー：

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

Markdown Anchorはハッシュマークをサポートしているため、ページ内のアンカーへのリンクは単に[Pookie](#pookie)

アンカーの生成は、実際にはGruber Markdownではサポートされていませんが、Markdown Extraなどの他の実装ではサポートされています。

Markdown Extraでは、アンカーIDはでヘッダーまたはサブヘッドに追加され{#pookie}ます。

Gitリポジトリページ（Gistsではない）のGithubフレーバーマークダウンは、すべてのヘッダー（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は、少なくともヘッダーにIDを割り当てる手段を提供します。これにより、簡単にリンクできます。MarkdownとMarkdown Extraの両方で通常のHTMLを使用できること、およびこの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の回答が異なります！）。マークダウンの実装に応じて生成されたアンカーを確認できるこのバベルマークを参照してください。