Harp Markdown

Markdown 易于編寫、易于閱讀的格式對于在網(wǎng)絡(luò)上編寫非常有用且流行。

Harp 默認(rèn)包含普遍有用的預(yù)處理器。這意味著你沒必要浪費時間在將你的 Markdown 轉(zhuǎn)化成 HTML——每件事都會正常工作。另外，Jade 和 EJS 文件可以把 Markdown 當(dāng)作局部視圖導(dǎo)入，讓你可以有效地復(fù)用代碼。

用法

Harp 的 asset pipeline 很容易使用。所有的處理過程都會自動發(fā)生，并不需要進(jìn)行設(shè)置。只需要把你的文件加一個 .md 后綴，Harp 網(wǎng)頁服務(wù)器會把它當(dāng)作一個 .html 文件來解析。 有些其他的 Markdown 解析器可能還支持 .markdown、.mdown、.txt 或者其他的擴展名。Harp 只會處理 .md 文件。

示例

這個項目在根目錄中包含 index.md 和 about.md 文件。

myproject/
  |- index.md
  +- about.md

index.md 以及 about.md 都會被當(dāng)作 .html 文件進(jìn)行解析。因此，對一下路徑的訪問都會工作：

• /
• /index
• /index.html
• /about
• /about.html

運行 Harp 的 編譯步驟 也會把文件當(dāng)作 index.html 和 about.html 導(dǎo)入進(jìn)來。

GitHub 最愛的 Markdown

Harp 還支持 GitHub Flavoured Markdown 補充語法。（這不包括 Github 專用功能，例如任務(wù)列表和 @mentions 等等。）這可以讓你寫一個圍起來的代碼塊：

```
function test() {
  console.log("Hello, world");
}
```

您還可以指定代碼語言：

```javascript
function test() {
  console.log("Hello, world");
}
```

function test() {
  console.log("Hello, world");
}

Harp 將代碼塊作為 HTML 提供：

<pre><code class="language-javascript">function test() {
  console.log(&quot;Hello, world&quot;);
}</code></pre>

在language-類名遵循W3C和WHATWG指定類型的代碼約定。這還允許你使用客戶端語法高亮庫（如Prism ）對其進(jìn)行樣式設(shè)置。

管理文件擴展名

你可能會發(fā)現(xiàn)自己想要創(chuàng)建另一個基于標(biāo)記的文件，而不是.html使用 Markdown。沒問題：只需.md添加你選擇的擴展名即可。例如，feed.xml.md將由 Harpfeed.xml代替。

使用EJS和Jade也是可能的，而且更有用。

另見

• 官方 Markdown 文檔
• GitHub Flavored Markdown 文檔
• 關(guān)于 Markdown 和局部視圖函數(shù)