如何链接到Multimarkdown中的命名锚?
我遇到过一些提及MultiMarkdown对内部链接/命名锚点的支持,但我无法find一个如何实际操作的例子。
那么,表示指定锚点的语法是什么,链接到它的语法是什么,就像链接到任何其他URL(只使用#foo而不是http://....
)?
在标准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上,链接不起作用,因为锚点被剥离了。)
如果在降价文件中有标题,则可以直接将其链接到文件中。
降价头 –
## The Header
这将生成一个隐含的ID #the-header
(用连字符replace内部空格,并使小写)。
要导航到这个ID,你可以像这样创build链接:
[Link to Header](#the-header)
这相当于:
<a href="/current_url#the-header">Link to Header</a>
请注意引用的名字是一个小写的#header
。
采取从Multimarkdown 用户指南 (感谢@MultiMarkdown在Twitter上指出)
[Some Text][]
将链接到名为“Some Text”的标题
例如
### Some Text ###
您select的可选标签,以帮助消除多个标题具有相同标题的情况:
### Overview [MultiMarkdownOverview] ##
这允许您使用[MultiMarkdownOverview]来特别参考此部分,而不是另一个名为Overview的部分。 这适用于atx或settext样式的头文件。
如果您已经使用标头使用的相同标识定义了一个定位点,则定义的定位点优先。
除了文档中的标题之外,您还可以为图像和表格提供标签,然后将其用于交叉引用。
我testing了Github Flavored Markdown一段时间,总结了4条规则:
- 标点符号将被丢弃
- 领先的白色空间将被丢弃
- 大写将被转换为较低
- 字母之间的空格将被转换为
-
说,
## 1.1 Hello World
这样写,
[Link](#11-hello-world)
完成。
创build内部链接(与部分相关)的最佳方法是创build列表,而不是链接,如果标题包含空格,则放置#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> <– 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更好。
在这里testingPandoc
这是我的解决scheme(来源于SaraubhM
的答案)
**Jump To**: [Hotkeys & Markers](#hotkeys-markers) / [Radii](#radii) / [Route Wizard 2.0](#route-wizard-2-0)
哪个给你:
跳转到 :热键和标记/半径/路线向导2.0
请注意来自的更改 和
.
以及-
在链接中的损失。
如果您正在寻找链接到GitHub中.MD文件中的内部头文件,那么只需将鼠标hover在单个头文件上,然后单击头部左侧显示的链接符号即可。 这实际上是您需要用来链接到文档中的特定标题的链接。