如何在Markdown中引用代碼？

Question

我主要為我的jekyll博客編寫markdown文件，所以可以使用液體方法

將原始HTML代碼插入markdown時。 整個降價代碼頁看起來很丑陋和混亂。 而且幾天后將很難修改。

因此，我可以使某些代碼成為引用樣式。 更具體地說， 將原始HTML代碼放在markdown代碼頁的底部，而只需在原始段落使用[...] 。 就像鏈接和圖像引用語法一樣。

原始碼在這里

• PARA1
• PARA2

<a href =“如果這里有一個很長很長的無聊的HTML鏈接，但我想放在底部” />

• para3各個

我想做的是在這里

• PARA1
• PARA2

[簡短的參考代碼]

• para3各個

<a href =“這里仍然有一個很長很無聊的HTML鏈接，但我把它放在底部了” />

Answer 1

Markdown除了鏈接以外，無法引用內容：

- item 1
- item 2
- [boring_link]
- para3

[boring_link]: https://boring.com/link.html "description of boring link"

使用Jekyll，您可以使用Liquid的capture標簽（即使在.md文件中）：

{% capture reference %}
… any html content …
{% endcapture %}
…
{{ reference }}

但這僅在您首先捕獲內容時才有效。

恐怕不可能完全按照自己的意願去做。 但是根據您實際的HTML內容，應該有多種選擇。

Answer 2

Jekyll具有用於顯示代碼的內置語法突出顯示功能，這不僅可以確保正確呈現代碼（即包裝在<pre>和<code>元素中），還可以添加特定於語言的樣式。

對於html突出顯示，您可以使用{% highlight html %} ，例如：

{% highlight html %}
    <div class="alert alert-success" role="alert">
    <strong>Boom!</strong> I'm a code example.
    </div>
{% endhighlight %}