web-dev-qa-db-ja.com

Multimarkdownで名前付きアンカーにリンクするにはどうすればいいですか?

MultiMarkdownが内部リンク/名前付きアンカーをサポートしているという言及はいくつかありますが、実際にそれを行う方法の1つの例を見つけることができません。

それでは、名前付きアンカーを示すための構文は何ですか、それにリンクするための構文は他のURLへのリンクと同じです(http://....の代わりに#fooのみを使用)。

481
masukomi

Multimarkdown Users Guide からの引用(/それを指摘してくれたTwitterの@MultiMarkdownに感謝します)

[Some Text][]は、「Some Text」というヘッダーへのリンクです。
例えば。

### Some Text ###

複数のヘッダに同じタイトルがある場合の曖昧さをなくすのを助けるためのあなたの選択の任意のラベル:

### Overview [MultiMarkdownOverview] ##

これにより、[MultiMarkdownOverview]を使用して、このセクションを特に参照することができます。概要という名前の別のセクションを参照することはできません。これはatxまたはsettextスタイルのヘッダで動作します。

ヘッダで使用されているのと同じIDを使用してすでにアンカーを定義している場合は、定義されているアンカーが優先されます。

文書内のヘッダーに加えて、相互参照にも使用できる画像や表にラベルを付けることができます。

125
masukomi

標準のMarkdownでは、リンクしたい場所に<a name="abcd"></a>というアンカーを置き、同じページの[link text](#abcd)でそれを参照するようにします。

この答え で説明されている理由で、これはname=ではなくid=を使用します。)

リモート参照はもちろん[link text](http://...#abcd)を使うことができます。

原文と訳文のテキストを管理できれば、これは夢のように機能します。アンカーは見出しの中にさえ現れることができます。

### <a name="head1234"></a>A Heading in this SO entry!

生成します:

このSO見出しの見出し

そして私達はそれにリンクすることさえできます:

and we can even [link](#head1234) to it so:

(SOでは、アンカーが取り除かれているのでリンクは機能しません。)

587
Steve Powell

マークダウンファイルにヘッダーがある場合は、ファイル内で直接リンクできます。

マークダウンヘッダー -

## The Header

これは暗黙のid #the-headerを生成します(内部スペースをハイフンに置き換えて小文字にします)。

このIDに移動するには、次のようにリンクを作成します。

[Link to Header](#the-header)

これは以下と同等です。

<a href="#the-header">Link to Header</a>

参照の名前は小文字の#headerです。

333
SaurabhM

Github Flavored Markdown をしばらくテストしたところ、4つの規則で要約できます。

  1. 句読点はドロップされます
  2. 先頭の空白は削除されます
  3. 大文字は小文字に変換されます
  4. 文字間のスペースは-に変換されます

たとえば、あなたのセクションがthisという名前の場合:

## 1.1 Hello World

このようにしてそれへのリンクを作成します。

[Link](#11-hello-world)
84
longkai

(セクションに関連する)内部リンクを作成する最善の方法はcreate listですが、リンクの代わりに#sectionまたは#section-titleをヘッダーにスペースが含まれる場合は入れます。

---- MARKDOWN ------------------------

Go to section
* [Hello](#hello)  
* [Hello World](#hello-world)
* [Another section](#new-section)    <-- it's called 'Another section' in this list but refers to 'New section'


## Hello
### Hello World
## New section

----リストのプレビュー------------------------

Go to section
Hello              <-- [Hello](#hello)                 -- go to `Hello` section
Hello World        <-- [Hello World](#hello world)     -- go to `Hello World` section
Another section    <-- [Another section](#new-section) -- go to `New section`

---- HTML ------------------------

<p>Go to section</p>
<ul>
<li><a href="#hello">Hello</a><br />
</li>
<li><a href="#hello-world">Hello World</a></li>
<li><a href="#new-section">Another section</a> &lt;– it’s called ‘Another section’ in this list but refers to ‘New section’</li>
</ul>
<h2 id="hello">Hello</h2>
<h3 id="hello-world">Hello World</h3>
<h2 id="new-section">New section</h2>

それがh1、h2、h3などのヘッダーであるかどうかは関係ありません、あなたは常にただひとつの#を使ってそれを参照します。
セクションリスト内のすべての参照は、上の例に示されているように小文字に変換する必要があります。

セクションへのリンクは小文字にする必要があります。 他の方法では動作しません。
このテクニックはすべてのMarkdownの変種、MultiMarkdownにもとてもうまくいきます。

現在私は Pandoc を使って文書フォーマットを変換しています。 MultiMarkdownよりもはるかに優れています。
Pandocのテストはこちら

19
rafr3

Mdcharmでは、このようになります。

* [Descripción](#descripcion)
* [Funcionamiento](#funcionamiento)
* [Instalación](#instalacion)
* [Configuración](#configuracion)

### Descripción {#descripcion}
### Funcionamiento {#funcionamiento}
### Instalación {#instalacion}
### Configuración {#configuracion}
6
Gonen09

これが私の解決策です( SaraubhM の答えから派生)

**Jump To**: [Hotkeys & Markers](#hotkeys-markers) / [Radii](#radii) / [Route Wizard 2.0](#route-wizard-2-0)

それはあなたに与えます:

移動先 :ホットキーとマーカー/半径/ルートWizard 2.0

.から-への変更と、リンク内の&の損失に注意してください。

2
Peet