程式碼(Code)
要在Markdown語要貼上程式碼給大家看有2種寫法
第一種 - 縮排
在程式碼的每一行文字前面增加1個tab
,或是4個空白
Example:
This is a sample code block.
function test() {
console.log("notice the blank line before this function?");
}
Result:
This is a sample code block.
function test() {
console.log("notice the blank line before this function?");
}
第二種 - 程式碼區塊
程式碼區塊的語法是在程式碼前後各用一組「```」包住程式碼
這種寫法雖然比較麻煩,但是相對比較明確,所以Gitbook官方也建議使用這種寫法
而看程式碼最需要的就是語法高亮(syntax hightlight)
雖然程式碼區塊的語法是Markdown規範的一部分,但語法高亮不是
在Gitbook中如果需要語法高亮的話,Gitbook有預設安裝了hightlight.js
套件
可以使用基於Markdown規範的語法提供某些程式語言的語法高亮
指定程式碼區塊的程式語言語法高亮,語法是在程式碼前面第一組3個「```」的後面可以加上你程式碼的語言名稱
支援的程式語言列表請參考highlight.js demo page
Example:Result:
This is a sample code block.
function test() {
console.log("notice the blank line before this function?");
}
第三種 - 行內程式碼區塊
程式碼區塊的寬度會以可編緝區域的最大寬度顯示
而行內程式碼區塊的寬度會由文字長度來決定
寫法非常簡單,在程式碼前後各用1個「`」包住程式碼
Example:
這本書是使用`gitbook bulid`指令編譯的
Result:
這本書是使用gitbook bulid
指令編譯的