如何使用 Discourse 三:Markdown 語法速查表

我們結合 [+ 新話題] 編輯器 toolbar (功能表?) 的順序,說明 Markdown 語法。

成品 語法 快捷鍵
Bold **Bold** Ctrl + B
Italic *Italic* Ctrl + I
超連結 [超連結](https://i98.tw) Ctrl + K
Image ![Image\|寬x高](圖檔網址)
Image ![Image](圖檔網址)

至於上面看到那個鍵盤圖示,是怎麼做的呢?很簡單,以Ctrl為例:
<kbd>Ctrl</kbd>


區隔線的作法,開頭三個 ___ (underscope _)即可,像這樣:


主標效果

# 主標語法

次標效果

## 次標語法


成品 語法 快捷鍵
項目符號 * 項目符號 Ctrl + Shift8
數字編號 1. 數字編號 Ctrl + Shift7
  • 項目符號 * 項目符號 Ctrl + Shift8
  • 項目符號 * 項目符號 Ctrl + Shift8
  1. 數字編號 1. 數字編號 Ctrl + Shift7
  2. 數字編號 2. 數字編號 Ctrl + Shift7
  3. 數字編號 3. 數字編號 Ctrl + Shift7

以下則是「詞標註」「行標註」和「段落標註」的介紹:

詞標註 是在要標註的詞,前後各加一個 backticks 符號,像這樣 我是詞標註

成品 語法 快捷鍵
詞標註 ‘詞標註’ Ctrl + Shift9

行標註 則是在該行的最前面加 > + Space bar(大於+半型空格)即可 "> ":

行標註

段落標註 和 Python的段落註䆁類似,前後各三個 backticks 包起來,要記得換行喔。
標註程式碼,討論中常會用到,很重要!

for number in numbers:
	do something

for number in range(a, b+1):
	do something

關於程式碼的標註,大家可以參考下面這一篇,寫得很清楚。非常感謝提供說明的兩位朋友!

6 Likes

補充 項目符號(bulleted lists)的更多用法:

一、項目符號的次項目,如何表示?

  • 項目符號
    • 次項目符號
    • 次項目符號
      • 次次項目符號
      • 次次項目符號
  • 項目符號
上述表現方式的語法如下(次項目前加兩個空白、次次項目加四個,依此類推):
* 項目符號
  * 次項目符號
  * 次項目符號
    * 次次項目符號
    * 次次項目符號
* 項目符號

二、間距
密間距:

  • 項目符號
  • 項目符號
  • 項目符號
語法:
* 項目符號
* 項目符號
* 項目符號

寬間距

  • 項目符號
  • 項目符號
  • 項目符號
語法:
* 項目符號
- 項目符號
* 項目符號

同場加映:數字編號(numbered lists)

  1. 數字編號
    1. 次數字編號
    2. 次數字編號
      1. 次次數字編號
      2. 次次數字編號
      3. 次次數字編號
  2. 數字編號
    1. 次數字編號
    2. 次數字編號
語法:(次項目前加四個空白、次次項目加八個,依此類推)
1. 數字編號
    1. 次數字編號
    2. 次數字編號
        1. 次次數字編號
        2. 次次數字編號
        3. 次次數字編號
2. 數字編號
    1. 次數字編號
    2. 次數字編號

另一種寫法,但只能有兩層:數字編號 & 次數字編號

  1. 數字編號
    1-1. 次數字編號
    1-2. 次數字編號
  2. 數字編號
    2-1. 次數字編號
    2-2. 次數字編號
語法:直接寫,不用加空白(加了也沒用),系統會自動排版
1. 數字編號
1-1. 次數字編號
1-2. 次數字編號
2. 數字編號
2-1. 次數字編號
2-2. 次數字編號