# Markdown 语法

By [ryanzzy.eth](https://paragraph.com/@ryanzzy) · 2022-03-27

---

Markdown 的设计哲学
--------------

> Markdown 的目標是實現「易讀易寫」。 不過最需要強調的便是它的可讀性。一份使用 Markdown 格式撰寫的文件應該可以直接以純文字發佈，並且看起來不會像是由許多標籤或是格式指令所構成。 Markdown 的語法有個主要的目的：用來作為一種網路內容的_寫作_用語言。

标题
--

Markdown 语法：

    # 第一级标题 `<h1>` 
    ## 第二级标题 `<h2>` 
    ###### 第六级标题 `<h6>` 
    

效果如下：

第一级标题 `<h1>`
============

第二级标题 `<h2>`
------------

###### 第六级标题 `<h6>`

强调
--

Markdown 语法：

    *这些文字会生成`<em>`*
    _这些文字会生成`<u>`_
    
    **这些文字会生成`<strong>`**
    __这些文字会生成`<strong>`__
    

_这些文字会生成_`<em>` _这些文字会生成_`<u>`

**这些文字会生成**`<strong>` **这些文字会生成**`<strong>`

换行
--

四个及以上空格加回车。 如果不想打这么多空格，只要回车就为换行，请勾选：`Preferences` - `Themes` - `Translate newlines to <br> tags`

列表
--

### 无序列表

Markdown 语法：

    * 项目一 无序列表 `* + 空格键`
    * 项目二
    * 项目二的子项目一 无序列表 `TAB + * + 空格键`
    * 项目二的子项目二
    

效果如下：

*   项目一 无序列表 `* + 空格键`
    
*   项目二
    
*   项目二的子项目一 无序列表 `TAB + * + 空格键`
    
*   项目二的子项目二
    

### 有序列表

Markdown 语法：

    1. 项目一 有序列表 `数字 + . + 空格键`
    2. 项目二 
    3. 项目三
    1. 项目三的子项目一 有序列表 `TAB + 数字 + . + 空格键`
    2. 项目三的子项目二
    

效果如下：

1.  项目一 有序列表 `数字 + . + 空格键`
    
2.  项目二
    
3.  项目三
    
4.  项目三的子项目一 有序列表 `TAB + 数字 + . + 空格键`
    
5.  项目三的子项目二
    

### 任务列表（Task lists）

Markdown 语法：

    - [ ] 任务一 未做任务 `- + 空格 + [ ]`
    - [x] 任务二 已做任务 `- + 空格 + [x]`
    

效果如下：

*   \[ \] 任务一 未做任务 `- + 空格 + [ ]`
    
*   \[x\] 任务二 已做任务 `- + 空格 + [x]`
    

图片
--

Markdown 语法：

    ![Doodle #1229](https://lh3.googleusercontent.com/uPkDcpvKG7HW_iYhOFmwYRwqd-YsSlYq6aRBk_C3ZLSjDU9J1CKd85dKc86wIZA1tPNYzcCAz-GU7SykDXGC8Oxo-_3t2-69hFyD=w600)
    格式: !Alt Text
    

效果如下:

![Doodle #1229](https://storage.googleapis.com/papyrus_images/276ff0008113f48775d3c756a9e4fc58baed095a1fedd3ecfe923f248e86a37d.png)

Doodle #1229

Markdown 语法：

    email <example@example.com>
    [GitHub](http://github.com)
    自动生成连接  <http://www.github.com/>
    

`Control + Shift + L` 可插入Markdown语法。 如果是 MWeb 的文档库中的文档，拖放或`CMD + Option + I` 导入非图片时，会生成连接。 效果如下：

Email 连接： [example@example.com](mailto:example@example.com) [连接标题Github网站](http://github.com) 自动生成连接像： [http://www.github.com/](http://www.github.com/) 这样

区块引用
----

Markdown 语法：

    某某说:
    > 第一行引用
    > 第二行费用文字
    

`CMD + Shift + B` 可插入Markdown语法。 效果如下：

某某说:

> 第一行引用 第二行费用文字

行内代码
----

Markdown 语法：

    像这样即可：`<addr>` `code`
    

`CMD + K` 可插入Markdown语法。 效果如下：

像这样即可：`<addr>` `code`

多行或者一段代码
--------

Markdown 语法：

    ```js
    function fancyAlert(arg) {
        if(arg) {
        $.facebox({div:'#foo'})
        }
    
    }
    

    
    `CMD + Shift + K` 可插入Markdown语法。
    效果如下：
    
    ```js
    function fancyAlert(arg) {
        if(arg) {
        $.facebox({div:'#foo'})
        }
    
    }
    

删除线
---

Markdown 语法：

    加删除线像这样用： ~~删除这些~~
    

效果如下：

加删除线像这样用： 删除这些

分隔线
---

以下三种方式都可以生成分隔线：

    ***
    
    *****
    
    - - -
    

效果如下：

* * *

* * *

* * *

注释和阅读更多
-------

Actions->Insert Read More Comment _或者_ `Command + .` **注** 阅读更多的功能只用在生成网站或博客时，插入时注意要后空一行。

---

*Originally published on [ryanzzy.eth](https://paragraph.com/@ryanzzy/markdown)*