2015-12-28 26 views
1

我們正在嘗試實現一個自動減價生成器,以實現易於維護的文檔。使反引號和鏈接與GitHub Markdown重疊工作

當提及變量的類型,我們願與?前綴它時,它是空的,它周圍使用反引號,並添加一個鏈接到其描述。例如:`?[Article](#article)`

但是,由於重疊,反引號會破壞鏈接語法。我們使用`?`[`Article`](#article)來代替鏈接,但它會在?Article之間創建一個空間,如下所示:?Article

是否有可能使它看起來像?Article僅在Article上有鏈接?

回答

1

我只是測試了這一點,並發現有?Article之間沒有空間。看起來只是一個空間,簡直就是GitHub的兩個模塊,即兩個模塊相互對立。

在反引號中包裝整個事物將不起作用,因爲反引號表示代碼,Markdown會將其內容視爲您想要顯示源代碼的代碼示例。

我能找到的最好的解決方法是使用直接<code>標籤:

<code>?[Article](https://stackoverflow.com/)</code> 

在這兩個的GitHub和堆棧溢出這使它像這樣:

? Article

(我使用了一個鏈接以堆棧溢出作爲鏈接目標,這裏我們僅以一個呈現的鏈接爲例,我期望#article在您的環境中同樣適用。)

在我看來,這甚至是一種合理的做你想做的方式。降價的反引號編譯爲<code>標籤,並inline HTML code is expressly permitted by Markdown

對於未覆蓋減價的語法任何標記,只需使用HTML本身。沒有必要在前言或分隔它以表明您正在從Markdown切換到HTML;你只需使用標籤。

+0

我不知道有可能在Markdown中使用內聯HTML,謝謝! –