如何在 Markdown 中链接到同一文档的一部分？

Question

我正在编写一个大型 Markdown 文档，并想在开头放置一个目录，该目录将提供指向文档中各个位置的链接。我该怎么做？

我尝试使用：

[a link](# MyTitle)

其中MyTitle 是文档中的标题，但这不起作用。

Answer 1

Github 会自动从您的标头中解析出锚标记。因此，您可以执行以下操作：

[Custom foo description](#foo)

# Foo

在上述情况下，Foo 标头生成了一个名为 foo 的锚标记

注意：所有标题大小只有一个#，# 和锚名称之间没有空格，锚标签名称必须小写，如果是多字，则用破折号分隔。

[click on this link](#my-multi-word-header)

### My Multi Word Header

更新

也可以与pandoc 一起使用。

Answer 2

这可能是过时的线程，但要在 Github 的 markdown 中创建内部文档链接，请使用...
（注意：小写#title）

# Contents
 - [Specification](#specification) 
 - [Dependencies Title](#dependencies-title) 

## Specification
Example text blah. Example text blah. Example text blah. Example text blah. 
Example text blah. Example text blah. Example text blah. Example text blah. 
Example text blah. Example text blah. Example text blah. Example text blah. 
Example text blah. Example text blah. 

## Dependencies Title
Example text blah. Example text blah. Example text blah. Example text blah. 
Example text blah. Example text blah. Example text blah. Example text blah. 
Example text blah. Example text blah. Example text blah. Example text blah. 
Example text blah. Example text blah. 

提出了一个很好的问题，所以我编辑了我的答案；

可以使用 - #、##、###、#### 对任何标题大小进行内部链接 我在下面创建了一个简单的示例... https://github.com/aogilvie/markdownLinkTest

Answer 3

在实验中，我找到了使用<div…/> 的解决方案，但一个明显的解决方案是将您自己的锚点放置在页面中您喜欢的任何位置，因此：

<a name="abcde">

之前和

</a>

在您要“链接”到的行之后。然后是一个降价链接，如：

[link text](#abcde)

文档中的任何地方都会将您带到那里。

<div…/> 解决方案插入一个“虚拟”除法只是为了添加id 属性，这可能会破坏页面结构，但<a name="abcde"/> 解决方案应该是相当无害的。

(PS: 可以把锚点in放到你想链接的那一行，如下：

## <a name="head1">Heading One</a>

但这取决于 Markdown 是如何处理的。例如，我注意到 Stack Overflow 答案格式化程序对此很满意！）

Answer 4

是的，markdown 会这样做，但您需要指定名称锚点<a name='xyx'>。

一个完整的例子，

这将创建链接
[tasks](#tasks)

在文档的其他地方，您创建命名的锚点（不管它叫什么）。

<a name="tasks">
   my tasks
</a>

请注意，您也可以将其包裹在标题周围。

<a name="tasks">
### Agile tasks (created by developer)
</a>

Answer 5

在pandoc 中，如果您在生成html 时使用选项--toc，则会生成一个目录，其中包含指向各节的链接，并从节标题返回目录。它与 pandoc 编写的其他格式类似，如 LaTeX、rtf、rst 等。所以使用命令

pandoc --toc happiness.txt -o happiness.html

这一点降价：

% True Happiness

Introduction
------------

Many have posed the question of true happiness.  In this blog post we propose to
solve it.

First Attempts
--------------

The earliest attempts at attaining true happiness of course aimed at pleasure. 
Soon, though, the downside of pleasure was revealed.

将产生这个作为 html 的主体：

<h1 class="title">
    True Happiness
</h1>
<div id="TOC">
    <ul>
        <li>
            <a href="#introduction">Introduction</a>
        </li>
        <li>
            <a href="#first-attempts">First Attempts</a>
        </li>
    </ul>
</div>
<div id="introduction">
    <h2>
        <a href="#TOC">Introduction</a>
    </h2>
    <p>
        Many have posed the question of true happiness. In this blog post we propose to solve it.
    </p>
</div>
<div id="first-attempts">
    <h2>
        <a href="#TOC">First Attempts</a>
    </h2>
    <p>
        The earliest attempts at attaining true happiness of course aimed at pleasure. Soon, though, the downside of pleasure was revealed.
    </p>
</div>

Answer 6

pandoc 手册解释了如何使用它们的标识符链接到你的标题。我没有检查其他解析器对此的支持，但据报道它在 github 上不起作用。

标识符可以手动指定：

## my heading text {#mht}

Some normal text here,
including a [link to the header](#mht).

或者您可以使用自动生成的标识符（在本例中为 #my-heading-text）。两者在pandoc manual中都有详细解释。

注意：这仅在转换为 HTML、LaTex、ConTeXt 时有效>、Textile 或 AsciiDoc。

Answer 7

通用解决方案

这个问题似乎根据markdown实现有不同的答案。
事实上，官方的 Markdown 文档对这个话题并没有提及。
在这种情况下，如果您想要一个可移植的解决方案，您可以使用 HTML。

在任何标题之前，或在同一标题行中，使用一些 HTML 标记定义一个 ID。
例如：<a id="Chapter1"></a>
您将在代码中看到这一点，但在呈现的文档中看不到。

完整示例：

查看完整示例（在线且可编辑）here。

## Content

* [Chapter 1](#Chapter1)
* [Chapter 2](#Chapter2)

<div id="Chapter1"></div>
## Chapter 1

Some text here.  
Some text here.
Some text here.

## Chapter 2 <span id="Chapter2"><span>

Some text here.  
Some text here.
Some text here.

要测试此示例，您必须在内容列表和第一章之间添加一些额外的空间或降低窗口高度。
此外，请勿在 ID 名称中使用空格。

Answer 8

如果您在想要导航到的标题中使用符号花哨，请记住一些额外的事情......

# What this is about


------


#### Table of Contents


- [About](#what-this-is-about)

- [⚡ Sunopsis](#9889-tldr)

- [:gear: Grinders](#it-grinds-my-gears)

- [Attribution]


------


## ⚡ TLDR


Words for those short on time or attention.


___


## It Grinds my :gear:s


Here _`:gear:`_ is not something like ⚙ or ⛭


___


## ⛤ Attribution


Probably to much time at a keyboard



[Attribution]: #9956-attribution

...标题字符串中的#、;、& 和: 之类的内容通常被忽略/条带化而不是转义，也可以使用引用样式链接，使快速使用更容易。

备注

GitHub 支持在提交、自述文件等中使用 :word: 语法。如果对使用它们感兴趣，请参阅 gist（来自 rxaviers）。

对于现代浏览器，几乎所有其他地方都可以使用十进制或十六进制； w3schools 的备忘单很方便，特别是如果使用带有符号的 CSS ::before 或 ::after 伪元素更符合您的风格。

奖励积分？

以防万一有人想知道如何将标题中的图像和其他链接解析为 id...

- [Imaged](#alt-textbadge__examplehttpsexamplecom-to-somewhere)


## [![Alt Text][badge__example]](https://example.com) To Somewhere


[badge__example]:
  https://img.shields.io/badge/Left-Right-success.svg?labelColor=brown&logo=stackexchange
  "Eeak a mouse!"

注意事项

MarkDown 渲染因地而异，所以像...

## methodName([options]) => <code>Promise</code>

... 在 GitHub 上会有一个带有id 的元素，例如...

id="methodnameoptions--promise"

... vanilla 卫生会导致id of...

id="methodnameoptions-codepromisecode"

... 意味着从模板编写或编译 MarkDown 文件要么需要针对一种 slugifeing 方式，要么为放置的各种 聪明 方式添加配置和脚本逻辑喜欢清理标题的文字。

Answer 9

Markdown 规范中没有这样的指令。对不起。

Answer 10

Gitlab 使用GitLab Flavored Markdown (GFM)

这里“所有 Markdown 渲染的标头都会自动获取 ID”

可以用鼠标来：

• 将鼠标移到标题上
• 将鼠标悬停在从标题左侧可见的悬停选择器上

• 使用鼠标右键复制并保存链接

  例如在 README.md 文件中我有标题：

## series expansion formula of the Boettcher function

它给出了一个链接：

https://gitlab.com/adammajewski/parameter_external_angle/blob/master/README.md#series-expansion-formula-of-the-boettcher-function

前缀可以去掉所以这里的链接很简单

file#header

这里的意思是：

README.md#series-expansion-formula-of-the-boettcher-function

现在它可以用作：

[series expansion formula of the Boettcher function](README.md#series-expansion-formula-of-the-boettcher-function)

也可以手动完成：用连字符替换空格。

活生生的例子是here

Answer 11

除了以上答案，

在 YAML 标头中设置选项 number_sections: true 时：

number_sections: TRUE

RMarkdown 将为您的部分自动编号。

要引用这些自动编号的部分，只需将以下内容放入您的 R Markdown 文件中：

[My Section]

My Section 是节的名称

无论部分级别如何，这似乎都有效：

# My section

## My section

### My section

Answer 12

使用 kramdown，看起来效果不错：

[I want this to link to foo](#foo)
....
....
{: id="foo"}
### Foo are you?

我看到有人提到过

[foo][#foo]
....
#Foo

工作效率高，但前者可能是除了标题或包含多个单词的标题之外的元素的不错选择。

Answer 13

因为在 cmets 中提到了 MultiMarkdown 作为一个选项。

在MultiMarkdown 中，内部链接的语法很简单。

对于文档中的任何标题，只需以[heading][] 格式提供标题名称即可创建内部链接。

在此处阅读更多信息：MultiMarkdown-5 Cross-references。

交叉引用

一个经常被要求的功能是让 Markdown 自动处理文档内链接就像处理外部链接一样容易。为此，如果存在名为“Some Text”的标题，我添加了将 [Some Text][] 解释为交叉链接的功能。

例如，[元数据][] 将带您到#元数据（或任何##元数据、###元数据、####元数据、#####元数据、######元数据）。

或者，您可以包含您选择的可选标签，以帮助消除多个标题具有相同标题的情况：

### 概述 [MultiMarkdownOverview] ##

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

如果您已经使用与标头相同的 id 定义了锚点，则定义的锚点优先。

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

Answer 14

<a name=""> 技巧的更多旋转：

<a id="a-link"></a> Title
------

#### <a id="a-link"></a> Title (when you wanna control the h{N} with #'s)