Markdown 是一種輕量級 (lightweight) 且易於使用的語法,它允許人們使用易讀易寫的純文字格式編寫文件

目錄

主要內容

Headers

  • 使用 # 字符
  • # 字符愈多,字體大小愈小

    # This is an <h1> tag
    ## This is an <h2> tag
    ###### This is an <h6> tag
    
    H1 tag
    ===
    H2 tag
    ---

Emphasis

  • 斜體字使用 *_ 字符
  • 粗體字使用 **__ 字符

    *This text is italic*
    _This text is also italic_
    
    **This text is bold**
    __This text is also bold__

Strikethrough

  • 使用 ~~ 刪除線字符

    This is a ~~strikethrough~~ .

Lists

Unordered

  • 可以使用 *-+ 字符

    * Item 1
    * Item 2
      * Item 2a
      * Item 2b

Ordered

  • 使用阿拉伯數字表示 (數字本身是否排序並不重要,通通使用相同的數字也可以)

    1. Item 1
    1. Item 2
       1. Item 2a
       1. Item 2b

Images

  • 形式為 ![Alt Text](URL)

    # 行內格式
    ![My avatar](/images/avatar.png "Avatar")
    
    # 參考連結格式
    ![My avatar2][logo]
    
    [logo]: /images/avatar.png "Avatar"

EX:

My avatar

My avatar2

  • 形式為 [Text](URL)

    # 行內連結
    [GitHub](https://github.com)
    
    # 帶有標題的行內連結
    [GitHub](https://github.com "GitHub's Homepage")
    
    # 參考連結
    [一個參考連結][text 1]
    
    [一個參考連結(數字)][1]
    
    [Google]
    
    [text 1]: https://www.mozilla.org
    [1]: https://www.google.com
    [Google]: https://www.google.com

EX:

GitHub

GitHub

一個參考連結

一個參考連結(數字)

Google

Blockquotes

  • 使用 > 字符
  • 可以在表格內使用行內格式

    >  Knowledge is **power**.

EX:

Knowledge is power.

Inline code

  • 使用 ` ` 字符

    This is an `<inline code>`.

EX:

This is an <inline code>.

Tables

  • 使用 - 來分隔列 (row) (第一列)
  • 使用 | 來分隔行 (column))
  • 使用 : 來對齊(擺左齊左、擺右齊右,都擺就置中)
  • 可以在表格內使用行內格式

    First Header | Second Header | Third Header
    ------------ | ------------- | ------------
    item11       | item12
    item21       | item22        | item23
    
    First Header | Second Header | Third Header
    ------------ |:-------------:| ------------:
    item11       | _item12_
    **item21**   | item22        | `item23`

EX:

First Header Second Header Third Header
item11 item12
item21 item22 item23

First Header Second Header Third Header
item11 item12
item21 item22 item23

Syntax highlighting

  • 使用 ` ` ` 字符

    ```javascript
    function doSomething(a) {
    b = a + 2;
    console.log(b * 3);
    }
    ```

EX:

function doSomething(a) {
  b = a + 2;
  console.log(b * 3);
}

Inline HTML

  • 可以在 Markdown 中直接寫入正確的 HTML

    <p> Hello World!! </p>
    <hr>
    <div> Buenos días </div>

EX:

Hello World!!


Buenos días

Horizontal divider

  • 三個或三個以上的符號必須在獨立的一行,前後不能有其他文字

    # 第一種
    ---
    
    # 第二種
    ***
    
    # 第三種
    ___

EX:




Reference

To know that we know what we know, and to know that we do not know what we do not know, that is true knowledge.

Nicolaus Copernicus

Author: Andy Chung
Article link: https://chiachin2686.github.io/2021/08/markdown-notes/
License: CC BY-NC 4.0