Github Markdown同页链接


98

假设我在同一个git hub Wiki页面中有两个点,为此我们将其称为place 1place 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).

替代方法是ToC。

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

有什么办法吗?注意-看到了这一点,所以我假设它是主题。同样,这涉及文件之间的切换,这涉及在同一文件之间的切换。



@flyx-谢谢,如果可以的话,我会回复=)
Alexander Craggs

2
这个答案可能与您相关。
flyx

@flyx有点晚了,但是谢谢!确实确实帮了我很多忙:)
Alexander Craggs

Answers:


135

这适用于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设计指南》


2
请注意,引用链接本身必须编码为小写。使用上面的示例,如果您链​​接到[here](#Place-2),则该链接将不起作用。请注意,在该示例中,标题如何称为“地方2”,(正确地)名为的链接[here](#place-2)
DaveL17

6
如果你有2个或多个标题具有相同名称Place的链接将被命名为placeplace-1place-2等,然后如果你也有一个明确的标题Place 2及其链接会place-2-1
凯文

1
答案仍然有用,因为它可以在Gitlab Wiki中使用。html方法(在gitlab Wiki中使用anchor标签)不起作用。我知道问题是关于github的。
恩迪塔

BitBucket似乎不支持它。我改用锚<a name="link">。
рüффп

25

例如,如果您有一堆具有相同名称的(sub-)标题,也可以创建命名的自定义锚。为此,请使用标头插入HTML标记:

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

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

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

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

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

2
谢谢,此解决方案有效,并且出于一个原因。更改GIT降价去年防止标题被添加#my heading了它必须是# my heading在锚加空格像(# my-heading)不起作用
MitchellK

0

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

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.