Markdown 入門基礎之教學語法大全

4,341 0

Markdown 語法是 Flarum 主推的內容輸入方案(另外還有 BBCode,下面也會講到),以下簡單介紹 Markdown 的使用方法,本文主要是寫給 Flarum 的新手們,幫助小白迅速成為大佬。

標題

標題是每篇文章都需要也是最常用的格式。在 Markdown 中,如果一段文字被定義為標題,只要在這段文字前加 # 號即可。註:「#」和標題之間有一個空格。以此類推,總共六級標題(H1 到 H6,# 號後必須加空格),不過 Flarum 只支援其中的 H1 到 H3,也就是你最多只能打三個「#」號。

# 一级标题
## 二级标题
### 三级标题

列表

熟悉 HTML 的同學肯定知道有序列表與無序列表的區別。在 Markdown 下,列表的顯示只需要在文字前加上 - 或 * 即可變為無序列表,有序列表則直接在文字前加 1. 2. 3. 符號要和文字之間加上一個字元的空格。

無序列表

- 1
- 2
- 3

有序列表

1. a
2. b
3. c

多層序列

- 嵌套列表
  + 嵌套列表
  + 嵌套列表
    - 嵌套列表
      * 嵌套列表
- 嵌套列表

引用

如果你需要引用一小段別處的句子,那麼就要用引用的格式。只需要在文字前加入 > 這種尖括號(大於號)即可。

> 例如这样

圖片與連結

插入連結與插入圖片的語法很像,區別在一個 ! 號,中括號為連結文字(圖片可以不寫),括號為連接地址:

新增連結

[Notte 博客](https://www.ikxin.com/)

進階連結

帶提示標題的連結

[鼠标移上来](https://www.google.com "Google 首页")

引用連結(引用內容不限,可以任意字元,甚至可以寫數字)

[引用式链接][Notte 博客]
[Notte 博客]: https://www.ikxin.com/

內置連結

[内部文件](../blob/master/LICENSE)

新增圖片

![图片介绍](https://img.8b5.cn/2018/07/26/5b5957facadf4.png)

免費圖庫推薦 sm.ms

該圖庫支援生成 Markdown 語法連結。

進階圖片

帶描述的圖片

![alt text](https://img.8b5.cn/2018/07/26/5b5957facadf4.png "Logo 文本")

引用式連結

![alt text][logo]
[logo]: https://img.8b5.cn/2018/07/26/5b5957facadf4.png "Logo 文本"

粗體、斜體、刪除線

Markdown 的粗體和斜體也非常簡單,用兩個星號包含一段文字就是粗體的語法,用一個星號包含一段文字就是斜體的語法。

**这里是粗体**
*这里是斜体*
~~这里是删除线~~

腳註

用於特殊標註,空格作為結束。

二月十四号^情人节 这天

程式碼框

如果你是個程式設計師,需要在文章裡優雅地引用程式碼框,在 Markdown 下實現也非常簡單,只需要用 `` 號 ` 把中間的程式碼包裹起來。寫法分兩種:

  1. 單個或兩個 `` 號 ` 代表內聯文字
分别是 `蔬菜` 和 ``水果``
  1. 三個 `` 號 ` 並換行包裹中間程式碼,就跟 BBCode 的 code 用法一致了(偷懶的話也可以按四個空格來實現)。

分隔符

在一行中用三個以上的星號 (*)、減號 (-)、下劃線 (_) 來建立一個分隔線。

***
---
___

提示:如果發現 Markdown 列表程式碼無效,請於第一行前換行(第一行換行)即可。


附上 Flarum 支援的 BBCode:

  1. 粗體:[b]bold[/b]
  2. 斜體:[i]italic[/i]
  3. 下劃線:[u]underline[/u]
  4. 刪除線:[s]strike[/s]
  5. 連結:[url=http://www.xfum.org/]链接[/url]
  6. 語法高亮:[code lang=php]<?php phpinfo(); ?>[/code]
  7. 字體顏色:[color=red]红色[/color] 或者 [color=#ff0000]红色[/color]
  8. 字體大小:[size=10]10字号[/size]
  9. 置中對齊:[center]居中内容[/center]
  10. 隱藏內容:[details=点击查看]隐藏内容[/details]
  11. 音訊:[audio]https://awk.tw/audio/How.to.pronounce.Vivaldi.mp3[/audio]
  12. 影片:[video]https://awk.tw/video/opera_new.mp4[/video]

另外還支援 [img][list] 等,因為 Markdown 已提供更好的實現方案,所以不推薦用 BBCode。

  1. 列表:
[LIST]
[*]Bullet 1
[*]Bullet 2
[/LIST]
[LIST=1]
[*]Entry 1
[*]Entry 2
[/LIST]
  1. 高亮內容(dev 0.6.2 新增)

程式碼:[hl]高亮内容[/hl]

評論

(0)

暫無評論,來說兩句吧

發佈評論

© 2026 一紙忘憂. 保留所有權利.

一紙忘憂的個人網站,關於技術探索與日常生活,記錄 Web 開發、後端與 DevOps 實踐,分享軟體工具、數位體驗,以及程式碼之外的見聞與思考。