簡體   English   中英

在 Markdown 中,鏈接到頁面片段的最佳方式是什么,即 #some_id?

[英]In Markdown, what is the best way to link to a fragment of a page, i.e. #some_id?

我試圖弄清楚如何使用 Markdown 引用頁面的另一個區域。 如果我添加一個,我可以讓它工作

<div id="mylink" /> 

對於鏈接,請執行以下操作:

[My link](#mylink)

但我的猜測是,還有其他方法可以在 Markdown 中創建不涉及直接div標簽的頁內鏈接。

有任何想法嗎?

看到這個答案

總之做一個目的地

<a name="sometext"></a>

插入 Markdown 標記中的任何位置(例如在標題中:

## heading<a name="headin"></a>

並使用降價鏈接鏈接到它:

[This is the link text](#headin)

或者

[some text](#sometext)

不要使用<div> - 這會弄亂許多渲染器的布局。

(我已將id=更改name=上面的name= 。有關乏味的解釋,請參閱此答案。)

我想這取決於您用於從 Markdown 生成 html 的內容。 我注意到,jekyll(默認情況下由 gihub.io 頁面使用)會自動將 id="" 屬性添加到它生成的 html 中的標題。

例如,如果你的降價是

My header
---------

生成的 html 將如下所示:

<h2 id="my-header">My header</h2>

所以你可以簡單地通過[My link](#my-header)鏈接到它

使用MarkdownPHP 版本,您還可以使用以下任一語法將標題鏈接到頁面內的片段標識符,如此處所述

Header 1            {#header1}
========

## Header 2 ##      {#header2}

進而

[Link back to header 1](#header1)
[Link back to header 2](#header2)

不幸的是,此語法目前僅支持標題,但至少它對構建目錄很有用。

HTML 頁面中鏈接的目標錨點可以是任何具有id屬性的元素。 請參閱 W3C 站點上的鏈接 這是相關部分的引用:

HTML 文檔中的目標錨可以由 A 元素(使用 name 屬性命名)或任何其他元素(使用 id 屬性命名)指定。

Markdown 將 HTML 視為 HTML(請參閱內聯 HTML ),因此您可以從您喜歡的任何元素創建片段標識符。 例如,如果您想鏈接到一個段落,只需將該段落包裝在一個段落標記中,並包含一個 id:

<p id="mylink">Lorem ipsum dolor sit amet...</p>

然后使用您的標准 Markdown [My link](#mylink)創建一個鏈接到片段錨點。 這將有助於保持您的 HTML 干凈,因為不需要額外的標記。

對於任何使用 Visual Studio Team Foundation Server (TFS) 2015 的人來說,它確實不喜歡嵌入的<a><div>元素,至少在標題中是這樣。 它也不喜歡標題中的表情符號:

### 🔧 Configuration 🔧

Lorem ipsum problem fixem.

被翻譯成:

<h3 id="-configuration-">🔧 Configuration 🔧</h3>
<p>Lorem ipsum problem fixem.</p>

因此鏈接應該使用該id (這會破壞 Visual Studio 中的這個和其他預覽擴展),或者刪除表情符號:

Here's [how to setup](#-configuration-) //🔧 Configuration 🔧
Here's [how to setup](#configuration) //Configuration

后一個版本在 TFSVisual Studio 的降價預覽中都可以在線工作。

在 Pandoc Markdown 中,您可以使用語法[span]{#anchor}在段落內的任意跨度上設置錨點,例如:

Paragraph, containing [arbitrary text]{#mylink}.

然后像往常一樣引用它: [My link](#mylink)

如果你想引用整個段落,那么最直接的方法是在段落的開頭添加一個跨度:

[]{#mylink}
Paragraph text.

暫無
暫無

聲明:本站的技術帖子網頁,遵循CC BY-SA 4.0協議,如果您需要轉載,請注明本站網址或者原文地址。任何問題請咨詢:yoyou2525@163.com.

 
粵ICP備18138465號  © 2020-2024 STACKOOM.COM