Skip to main content

Markdown 語法記錄

之前都是使用 html 方式來寫文章,最近看到群內還滿多人都在使用 Markdown 這個編輯器來記錄文章,以下參數大多都是以本站 BookStack 服務環境記錄。


快捷鍵

Windows 和 Linux / Mac 描述
Ctr+S / Cmd+s 保存草稿
Ctrl+Enter / Cmd+Enter 保存頁面並繼續
Ctrl+Shift+K / Cmd+Shift+K 顯示鏈接站內文章
Ctrl+Shift+I / Cmd+Shift+I 插入圖片

標題語法

標題由大到小,一共有六個等級,也就是我們常說的H1字體到H6字體。
其中H1是最大的字體,經常被拿來作為標題的方式標示,H2與H3都適合拿來作為副標題的標示。
H3等級以後的文字實際上都差不多大小了,因此我不建議使用到H3以後的等級。

# H1
## H2
### H3
以此類推...
利用#字符號的多寡來定義字體大小
  • 快捷鍵
Windows 和 Linux / Mac 描述
Ctrl+1 / Cmd+1 標頭大(h2)
Ctrl+2 / Cmd+2 標頭中(h3)
Ctrl+3 / Cmd+3 標頭小(h4)
Ctrl+4 / Cmd+4 標頭小(h5)

記得!!!使用#字號,後面一定要按一個空白鍵!!!

顯示結果如下

H1

H2

H3

分隔線介紹

文字1
---
文字2
  • 顯示結果如下(無Enter)中間沒有一條線

文字1

文字2

  • 顯示結果如下(有Enter)

文字1


文字2

斜體 / 粗體 / 刪除線 介紹

*斜體*
**粗體**
~~刪除線~~
  • 顯示結果如下
    斜體
    粗體
    刪除線

任務列表

- [] A任務
- [] B任務
- [x] C任務
- [] D任務
  • 顯示結果如下
  • [] A任務
  • [] B任務
  • C任務
  • [] D任務

超連結

[文字](https://)

跳出新視窗
方案一
GitHub上使用
[文字](https://){:target="_blank"}

方案二
使用 HTML 語法來顯示此功能
<a href="http://" target="_blank">test</a>
Windows 和 Linux / Mac 描述
Ctrl+K / Cmd+K 插入連結

引用

>文字內容
>>縮行
>>>縮行
(以此類推)
  • 快捷鍵
Windows 和 Linux / Mac 描述
Ctrl+6 / Cmd+6
Ctrl+Q / Cmd+Q
引用
  • 顯示結果如下

文字內容

縮行

縮行

程式碼(區)

```(使用語言)
程式碼內容
  • 顯示結果如下
CREATE DATABASE IF NOT EXISTS wordpress DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; #在資料庫裡新增BookStack表單
GRANT ALL PRIVILEGES ON wordpress.* TO 'wpuser'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION; #密碼請自己輸入好記錄的密碼
FLUSH PRIVILEGES;
  • 快捷鍵
Windows 和 Linux / Mac 描述
Ctrl+7 / Cmd+7
Ctrl+E / Cmd+E
程式碼(區)

程式碼(一段)

Use the `printf()` function.
  • 顯示結果如下
    Use the printf() function.

  • 快捷鍵

Windows 和 Linux / Mac 描述
Ctrl+8 / Cmd+8
Ctrl+Shift+E / Cmd+Shift+E
程式碼(一段)

表格

|姓名|性别|年龄|國籍|
  |---|----|----|---|
  |有大JJ的妹子|男|94|日本|
  |有大ㄋㄋ的漢子|女|87|美國|
  • 顯示結果如下
    姓名 性别 年龄 國籍
    有大JJ的妹子 94 日本
    有大ㄋㄋ的漢子 87 美國

文字顏色


由於 Markdown 沒有顏色的語法,所以我們可以使用 HTML 語法來使用

浅红色文字:<font color="#dd0000">浅红色文字:</font><br/>
深红色文字:<font color="#660000">深红色文字</font><br/> 
  • 顯示結果如下
    淺红色文字:淺红色文字
    深红色文字:深红色文字

背景色


<table><tr><td bgcolor=#FF00FF>背景色的设置是按照十六进制颜色值:#7FFFD4</td></tr></table>
<table><tr><td bgcolor=#FF83FA>背景色的设置是按照十六进制颜色值:#FF83FA</td></tr></table>
<table><tr><td bgcolor=#D1EEEE>背景色的设置是按照十六进制颜色值:#D1EEEE</td></tr></table>
<table><tr><td bgcolor=#C0FF3E>背景色的设置是按照十六进制颜色值:#C0FF3E</td></tr></table>
  • 顯示結果如下
背景色的设置是按照十六进制颜色值:#7FFFD4
背景色的设置是按照十六进制颜色值:#FF83FA
背景色的设置是按照十六进制颜色值:#D1EEEE
背景色的设置是按照十六进制颜色值:#C0FF3E

文字列表1


如果想要讓文字有階層的話可以在第二行按下 「 tab 」鍵就可以有階層的樣子了

* 123
按下 tab 鍵	* 456
  • 顯示結果如下
  • 123
    • 456

文字列表2


1. 列出所有元素:
   - 無序列表元素 A
       1. 元素 A 的有序子列表
   - 前面加四个空格
2. 列表里的多段換行:
   前面必須加四个空格,
   這樣換行,整体的格式不會亂
3. 列表裡引用:

   > 前面空一行
   > 仍然需要在 >  前面加四个空格
  • 顯示結果如下
  1. 列出所有元素:

    • 無序列表元素 A
      1. 元素 A 的有序子列表
    • 前面加四个空格
  2. 列表里的多段換行: 前面必須加四个空格, 這樣換行,整体的格式不會亂

  3. 列表裡引用:

    前面空一行 仍然需要在 > 前面加四个空格

文字大小


<font size=1>内容1</font>
<font size=2>内容2</font>
<font size=3>内容3</font>
<font size=4>内容4</font>
<font size=5>内容5</font>
<font size=6>内容6</font>
<font size=7>内容7</font>
Size:文字大小。是由1到7來設定大小的。瀏灠器默認值為3
  • 顯示結果如下
    内容1
    内容2
    内容3
    内容4
    内容5
    内容6
    内容7
  1. 列出所有元素:

    • 无序列表元素 A
      1. 元素 A 的有序子列表
    • 前面加四个空格
  2. 列表里的多段换行: 前面必须加四个空格, 这样换行,整体的格式不会乱

  3. 列表里引用:

    前面空一行 仍然需要在 > 前面加四个空格

  4. 列表里代码段:

    前面四个空格,之后按代码语法  书写
        或者直接空八个,引入代码块
    
    

文字對齊位置


<p align="left">這個段落文字靠左對齊</p>
<p align="center">這個段落文字置中對齊</p>
<p align="right">這個段落文字靠右對齊</p>
  • 顯示結果如下

這個段落文字靠左對齊

這個段落文字置中對齊

這個段落文字靠右對齊

線上影片


<iframe width="560" height="315" src="https://www.youtube.com/embed/A1gwST5J3h4" frameborder="0" allowfullscreen></iframe>
  • 顯示結果如下

訊息


  • 提示訊息
<p class="callout info"><strong>填寫文字</strong></p>
  • 顯示結果如下

填寫文字

  • 快捷鍵
Windows 和 Linux / Mac 描述
Ctrl+9 / Cmd+9 提示訊息
  • 警告訊息
<p class="callout warning"><strong>填寫文字</strong></p>
  • 顯示結果如下

填寫文字

  • 成功訊息
<p class="callout success"><strong>填寫文字</strong></p>
  • 顯示結果如下

填寫文字

  • 禁止訊息
<p class="callout danger"><strong>填寫文字</strong></p>
  • 顯示結果如下

填寫文字

縮排


因 Markdown 無法實現段首縮排,因此只能用手動增加語法來執行縮排

  • 縮排前

您好呀:

  • 縮排後

  您好呀:

  • 縮排語法是用 HTML 語法來使用
&emsp;&emsp;您好呀:

區塊折疊


可以在畫面上做區塊折疊

  • 語法
<details>
   <summary>Toggle me!</summary>

   Peek a boo!

</details>
  • 顯示結果:
Toggle me! Peek a boo!
  • 語法
<details>
   <summary>Shopping list</summary>

    * Vegetables
    * Fruits
    * Fish

</details>
  • 顯示結果:
Shopping list
* Vegetables
* Fruits
* Fish

錨點


BUBU 希望在內容可以在同頁面做跳轉,那類示跟網址連線語差不多只是還需要在多打參數就可以了

  • 跳轉語法
[標題](#bkmrk-標題)

# 標題
  • 測式結果

訊息




參考相關網頁