有支援 Github Flavored 的 Markdown 語言

使用 Markdown 來撰寫文件真的相當方便，不只可以快速地將文件結構組織起來，現在我更拿它來作筆記、寫部落格，像現在這篇文章就是使用 Github Pages 的服務，加上使用 Jekyll 工具，然後搭配 Markdown 來寫文章，基本的語法可以參考 Markdown 語法說明。

Github Flavored

然而在文章中常會放上程式碼，這時候如果有語法高亮，那就完美了！Github Flavored 就是提供這樣的功能，寫法也很簡單：

```javascript
function foo() {
  var bar = '';
  if (bar === 'Awesome'){
    return true
  }
}
```

上面這樣的寫法，透過 Github Flavored 的 highlighter-rouge 去渲染後，就會變成這樣：

function foo() {
  var bar = '';
  if (bar === 'Awesome'){
    return true
  }
}

是不是看起來更清楚了！而且 Github Flavored 支援超多種語言，參考下面的語言識別碼做設定：

Jekyll Syntax Highlighting

開頭有提到，我使用 Github Pages 加上 Jekyll，然後搭配 Markdown 來寫文章，很多時候文章會列出多種程式碼，因此程式碼的顏色樣式是提高閱讀性的重要功能，這裡我使用 Rouge 來幫我為程式碼加上顏色，他支援 183 種程式碼，幾乎會用到的程式語言都支援了，不過在 Markdown 中使用的時候，要注意他對應的程式語言分析器關鍵字，也就是 Markdown 用來標示程式碼段落所用的程式語言名稱，如下面的 javascript 這個關鍵字：

 
```javascript
function foo() { /* 略 */}
```

在 Rouge 的 GitHub Wiki 中，有他所有支援的程式碼語言與分析器對照表，詳細請參考 List of supported languages and lexers，我把我比較可能會用的做成表格列在下方：

更多資訊請參考以下的參考資料。

參考資料：

• GitHub Guides - Mastering Markdown
• List of supported languages and lexers
• github/linguist - languages.yml
• GitHub Flavored Markdown (GFM) language IDs