Github Markdown 同页链接

问题描述 投票:0回答:7

假设我在同一个 git hub wiki 页面中有两个点,我们将其称为

place 1
place 2

##Title

###Place 1

Hello, this is some text to fill in this, [here](place2), is a link to the second place.

###Place 2

Place one has the fun times of linking here, but I can also link back [here](place1).

替代方案是目录。

##Title
[ToC]
###Place 1
###Place 2

有什么办法可以做到这一点吗? 注意 - 看过this,所以我假设它是主题。 另外,这涉及到文件之间的转换,这个涉及到同一文件之间的转换。

github hyperlink markdown anchor
7个回答
285
投票

这可以在 Github 上运行:

## Title

### Place 1

Hello, this is some text to fill in this, [here](#place-2), is a link to the second place.

### Place 2

Place one has the fun times of linking here, but I can also link back [here](#place-1).

### Place's 3: other example

Place one has the fun times of linking here, but I can also link back [here](#places-3-other-example).

转换规则总结:

  • 标点符号将被删除
  • 前导空格将被删除
  • 大写将转换为小写
  • 字母之间的空格将转换为
    -

LivingSocial API 设计指南

是一个很好的示例文档,包含大量链接和格式

43
投票

还可以创建命名的自定义锚点,例如,如果您有一堆同名的(子)标题。要通过标头执行此操作,请插入 HTML 标记:

<h4 id="login-optional-fields">
Optional Fields
</h4>

然后通过ID属性链接到它:

[see above](#login-optional-fields)

也可以将锚标记直接添加到文档中:

<a id="my-anchor"></a>

10
投票

从 GitHub Gist 复制 - 原始帖子位于here

要创建跳转到自述文件不同部分的锚链接(如交互式目录),首先创建一个标题:

#Real Cool Heading

该标题的锚链接是小写标题名称,其中有空格,带有破折号。您始终可以通过访问 Github.com 上的自述文件并单击将鼠标悬停在标题左侧时出现的锚点来获取锚点名称。复制从 #:

开始的所有内容
#real-cool-heading

无论您想要链接到真正的酷标题部分,请将所需的文本放在括号中,然后将锚链接放在括号中:

[Go to Real Cool Heading section](#real-cool-heading)

7
投票

接受的答案对我不起作用,因为我的标题也是一个链接:

之前(不起作用):

Table of contents 

 1. [Header Name](#header-name)


### [Header Name](https://google.com)

之后(为我工作):

Table of contents 

 1. [Header Name](#header-name)


### Header Name

https://google.com

这是当你不想拥有 html 并希望使用已接受的解决方案并在自述文件中进行一些权衡时。


3
投票

示例1:

##Title

###Place 1<span id="place1">HelloWorld</span>

Hello, this is some text to fill in this, [here](#place2), is a link to the second place.

###Place 2<span id="place2">HelloWorld</span>

Place one has the fun times of linking here, but I can also link back [here](#place1).

这是一个可以从 place1 跳转到 place2 以及从 place2 跳转到 place1 的版本

##Title

###[Place 1](#Place-2)<span id="place1">HelloWorld</span>

Hello, this is some text to fill in this, [here](#place2), is a link to the second 
place.

###Place 2(#Place-1)<span id="place2">HelloWorld</span>

Place one has the fun times of linking here, but I can also link back [here](#place1).

1
投票

不幸的是,GitHub wiki 似乎从您添加到 wiki 页面的自定义 HTML 中删除了所有“id=..”标签,因此页面中唯一有效的锚点是标题。


0
投票

使用“name”属性而不是“id”作为锚点对我有用:

# <a name="myAnchorId"/> 1) My Anchor label (with comment)
...
[My link label](#myAnchorId)
© www.soinside.com 2019 - 2024. All rights reserved.