當文章有分類,需要快速閱讀,通常會先在文首部寫一個目錄,點擊可以跳轉。
為文章寫目錄,特別在文章較長的時候,有助於對內容的整體把握,能提高閱讀效率。
以下,將寫一個基本的錨目錄demo,然后特別說明需要注意的幾點。
Table Of Content
Demo
Table Of Contents
Installation Instructions
Usage Instructions
Troubleshooting
Compatibility
Notes and Miscellaneous
Building the Extension Bundles
Next Steps, Credits, Feedback, License
Something you should know
Installation Instructions
blablablabla
Usage Instructions
blablablabla
Troubleshooting
blablablabla
Compatibility
blablablabla
Notes and Miscellaneous
blablablabla
Building the Extension Bundles
blablablabla
Next Steps
blablablabla
Credits
blablablabla
Feedback
blablablabla
用htmla標簽實現的錨鏈接
除了用markdown中的錨定義,我們還可以在需要的時候使用html中的a鏈接的name屬性。實現傳統的錨點。
//點擊:
<a href="#test">Something you should know</a>
//跳轉至:
<a name="test">用htmla標簽實現的錨鏈接</a>
注意:markdown 的錨使用中需要特別注意的幾點
語法
目錄(Table Of Content)
[鏈接的value值,任意名稱](#*1 anchor-name)
錨
#*n Anchor Name
//可以是一級標題、二級、三級····
1. 命名規則
在目錄中:
- 鏈接的名稱anchor-name必須全部是小寫的,和錨中的名稱不區分大小寫匹配
- anchor-name對應的錨的名稱中的空格要用
“-”
替換 - anchor-name不能含有
“:”
、“()”
、“.”
、%
、$
等等特殊字符,最好就不要有任何字符 - 目錄的部分可以是多種樣式,例如斜體,粗體,本身都是等級標題,甚至列表元素都行
在錨中:
(指的是正文的標題)
- 不能含有
“:”
、“()”
、“.”
等字符 - 錨只要是標題就行,他可以是任意等級,還可以是列表元素,例如無序列表。
2. 如果錨需要特殊符號該怎么辦?
寫url的時候anchor-name 直接跳過全部的特殊字符即可,如下示例: