Jekyll / Markdown HTML注釋標記轉換為文字

Question

我在Jekyll v1.4.2 for Windows中使用Markdown，我目前將我的摘錄標記設置為“< - excerpt - >”

但是，當我將注釋標記放在我的.markdown文件中時，如下所示：

blog entry excerpt is here
<!--excerpt-->

blog entry continues

Jekyll將注釋標記中的<和>轉換為>和<，並且注釋顯示在我的最終HTML中，如下所示：

<p> blog entry excerpt is here &lt;!--excerpt&gt;</p>
<p> blog entry continues</p>

有趣的是，標簽仍然可以在博客中識別和摘錄

要將標記作為實際注釋，我必須這樣做：

blog entry excerpt is here

<!--excerpt-->

blog entry continues

這給了我：

<p> blog entry excerpt is here</p>
<!--excerpt-->
<p> blog entry continues</p>

這是Jekyll的預期行為嗎？ 我找不到其他任何人這個問題，花了我幾個小時才弄清楚，所以希望至少這是幫助別人。

Answer 1

看起來這是Jekyll及其Markdown處理器的預期行為。 根據段落元素的Markdown規范 ，

段落只是一個或多個連續的文本行，由一個或多個空行分隔。

從本質上講，您的摘錄被解釋為Paragraph元素的一部分。 當您在Comment和前一行之間添加空白行時，它會被放置在結束</p>標記之后，並按預期顯示。

Answer 2

使用redcarpet markdown解析器...它非常寬容，更容易讓你在.md文件中使用HTML。 （沒有HTML標記出現在你不想要的地方）

1. cd你的/ project / dir
2. gem install redcarpet
3. bundle install
4. 將此行添加到您的Gemfile gem 'redcarpet'
5. 將此行添加到_config.yml markdown: redcarpet

當我想在.md中使用HTML時，這對我有用，但是html標記本身被渲染到服務頁面中。

希望這對你有用！