如何链接到Multimarkdown中的命名锚点？

Question

我遇到过一些关于MultiMarkdown对内部链接/命名锚点的支持的提及,但我无法找到如何实际执行此操作的单个示例.

那么,表示命名锚的语法是什么,链接到它的语法是什么,与链接到任何其他URL(仅使用#foo而不是http://....)相同？

Answer 1

在标准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上,链接不起作用,因为锚被剥离.)

Answer 2

如果您在markdown文件中有标题,则可以直接在文件中链接它们.

Markdown标题 -

## The Header

这将生成一个隐式id #the-header(用连字符替换内部空格并使其成为小写).

要导航到此ID,您可以创建如下链接:

[Link to Header](#the-header)

这相当于:

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

请注意,引用的名称是小写的#header.

Answer 3

取自Multimarkdown 用户指南(感谢Twitter上的@MultiMarkdown指出)

[Some Text][]将链接到名为"Some Text"的标题,
例如

### Some Text ###

您选择的可选标签可帮助消除歧义多个标题具有相同标题的情况:

### Overview [MultiMarkdownOverview] ##

这允许您使用[MultiMarkdownOverview]专门引用此部分,而不是另一个名为Overview的部分.这适用于atx或settext样式的标头.

如果您已使用标头使用的相同ID定义了锚,则定义的锚优先.

除了文档中的标题之外,您还可以为图像和表格提供标签,然后也可以用于交叉引用.

Answer 4

我测试了Github Flavored Markdown一段时间,可以总结四个规则:

1. 标点符号将被删除
2. 领先的白色空间将被丢弃
3. 大写将转换为更低
4. 字母之间的空格将转换为 -

例如,如果您的部分命名为:

## 1.1 Hello World

以这种方式创建一个链接:

[Link](#11-hello-world)

Answer 5

创建内部链接(与部分相关)的最佳方法是创建列表但不是链接,如果标题包含空格,请放入#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

Answer 6

在mdcharm中它是这样的:

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

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