markdown文件編寫
Markdown是一種可以使用普通文字編輯器編寫的標記語言,通過簡單的標記語法,它可以使普通文字內容具有一定的格式。Markdown的語法簡潔明瞭、學習容易,而且功能比純文字更強,因此有很多人用它寫部落格。
文字樣式
標題
Markdown 支援兩種標題的類 atx 形式
類 Atx 形式則是在行首插入 1 到 6 個 # ,對應到標題 1 到 6 階,例如:
# 這是 H1
## 這是 H2
###### 這是 H6
區塊引用 Blockquotes
Markdown 標記區塊引用是使用> 的引用方式,在 Markdown 檔案中建立一個區塊引用,那會看起來像是你自己先斷好行,然後在每行的最前面加上 > ;Markdown 也允許只在整個段落的第一行最前面加上 > ;區塊引用可以巢狀(例如:引用內的引用),只要根據層次加上不同數量的 > 。
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
列表
Markdown 支援有序列表和無序列表。無序列表使用星號、加號或是減號作為列表標記:
* Red
* Green
* Blue
有序列表則使用數字接著一個英文句點,很重要的一點是,在列表標記上使用的數字並不會影響輸出的 HTML 結果:
3. Bird
1. McHale
8. Parish
列表專案可以包含多個段落,每個專案下的段落都必須縮排 4 個空格或是 1 個製表符,也允許只是段前縮排4個空格或一個製表符,如果要在列表專案內放進引用,那 > 就需要縮排。
程式碼區塊
新增內嵌程式碼可以使用一對回勾號 `alert('Hello World')`.對於插入程式碼, Ghost支援標準的Markdown程式碼和GitHub Flavored Markdown (GFM) 。標準Markdown基於縮排程式碼行或者4個空格位或是 1 個製表符就可以,一個程式碼區塊會一直持續到沒有縮排的那一行(或是檔案結尾)。
GFM 使用三個回勾號```
```swift高亮顯示
分隔線
你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線:
***
*****
- - - - - -
區段元素
連結
Markdown 支援兩種形式的連結語法: 行內式和參考式兩種形式
要建立一個行內式的連結,只要在方塊括號後面緊接著圓括號並插入網址連結即可,如果你還想要加上鍊接的 title 文字,只要在網址後面,用雙引號把 title 文字包起來即可,例如:
This is [an example](http://example.com/ "Title") inline link.
參考式的連結是在連結文字的括號後面再接上另一個方括號,而在第二個方括號裡面要填入用以辨識連結的標記:
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
強調
Markdown 使用星號(*)和底線(_)作為標記強調字詞的符號,被 * 或 _ 包圍的字詞會被轉成用 標籤包圍,用兩個 * 或 _包起來的話,則會被轉成 ,例如:
*single asterisks*
_single underscores_
但是如果 * 和 _ 兩邊都有空白的話,它們就只會被當成普通的符號。
圖片
Markdown 使用一種和連結很相似的語法來標記圖片,同樣也允許兩種樣式: 行內式和參考式。
行內式的圖片語法看起來像是:
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")
(一個驚歎號 !; 接著一個方括號,裡面放上圖片的替代文字;接著一個普通括號,裡面放上圖片的網址,最後還可以用引號包住並加上 選擇性的 'title' 文 字)
參考式的圖片語法則長得像:
![Alt text][id]
id是圖片參考的名稱,圖片參考的定義方式則和連結參考一樣:[id]: url/to/image "Optional title attribute"
自動連結
Markdown 支援以比較簡短的自動連結形式來處理網址和電子郵件信箱,只要是用方括號包起來, Markdown 就會自動把它轉成連結。一般網址的連結文字就和連結地址一樣,例如:
<http://www.baidu.com>
反斜槓
Markdown 支援以下這些符號前面加上反斜槓來幫助插入普通的符號:
\ 反斜線;
` 反引號
* 星號
_ 底線
{} 花括號
[] 方括號
() 括弧
# 井字號
+ 加號
- 減號
. 英文句點
! 驚歎號
相關文章
- MarkDown文件的編寫
- 使用 VS Code + Markdown 編寫 PDF 文件
- znai: 使用Markdown編寫Java文件系統AIJava
- 請不要使用Markdown編寫文件 - buttondown
- VS Code 搭建合適的 markdown 文件編寫環境
- vscode編寫markdownVSCode
- 用vim編寫markdown
- 怎樣使用typora寫markdown文件
- 文件編寫
- Markdown 編輯器寫文章
- Markdown 編寫技巧彙總(一)
- 掘金-Markdown 編輯器寫文章
- markdown 文件標題樣式自動編號
- 用掘金-Markdown 編輯器寫文章
- LaTeX 編寫中文文件
- react,vue編寫介面文件ReactVue
- 小白折騰伺服器(八):用 Markdown 寫介面文件伺服器
- 在 VSCode 中編寫 Markdown 的進階指南VSCode
- 無需離開 Visual Studio 即可編寫 Markdown
- 使用Typora編寫Markdown你真的會了嗎
- 編寫資料庫設計文件資料庫
- 如何編寫友好的說明文件?
- .md,markdown檔案的基本常用編寫語法
- markdown中嵌入typst文件
- mindmaster匯出markdown文件AST
- 如何在 Linux 上用 Markdown 編寫電影劇本Linux
- Markdown 編輯器 中書寫多行大括號公式公式
- 敏捷開發,如何編寫架構文件敏捷架構
- Element 文件中的 Markdown 解析
- Markdown文字編輯工具——Easy Markdown for MacMac
- C# 將PDF文件轉換為Markdown文件C#
- Markdown編輯器
- Markdown 寫部落格
- 編寫架構文件的最佳實踐 - Singh架構
- Markdown文件編輯神器typora的安裝,免啟用,附安裝包
- ?用 Laravel 開發的一個輕鬆的 Markdown 文件編輯專案Laravel
- Sublime Text 快速校驗 Markdown 文件
- vscode markdown格式化的外掛編寫(1)[釋出流程]VSCode