Markdown 語法入門

Burjal本尊發表於2017-12-19

Markdown

Markdown作為一種使用普通文字編輯器編寫的標記語言，通過簡單的標記語法，設定文字不同的格式。以實現 [易讀易寫] 的目標。

Markdown為編寫HTML提供了很好的實現，並避免了伴隨的複雜性和醜陋難看。Markdown的語法全由一些符號組成，語法簡單易上手。

本文介紹Markdown語法入門。

一、語法介紹

##1.1 標題

###1.1.1 Setext形式 類Setext形式是用底線的形式，利用 = (最高階標題) 和 - (第二階標題)，例如：

This is H1
===========
This is H2
-------------------
複製程式碼

This is H1

This is H2

注意：其中，任何數量的 = 和 - 都是等效的。

###1.1.2 Atx形式

類Atx形式是在行首插入 1 到 6個 #，對應分別為標題 1 到 6 階，例如：

# H1 #
## H2 ##
### H3 ###
#### H4 ####
##### H5 #####
##### H6 #####
複製程式碼

H1

H2

H3

H4

H5
H6

通常，若為了美觀用，可以在行尾加上 #，行尾的 # 不強制要求和開頭一樣，只有行首的字元數確定標題對應的階數。

##1.2 區塊引用Blockquotes

Markdown 標記區塊引用類似email中用 > 的引用方式。在每行的前面加上 >。 同樣，Markdown允許只在整個段落的第一行最前加上 > 。 區塊引用也可以巢狀，根據不同層次加上不同數量的 > 即可。 引用的區塊內同樣可以使用其他Markdown 語法，包括標題，列表，程式碼區塊等。

> 區塊引用...
>
> 區塊引用...

> 段落只需要要在第一行加上 
整個段落即引用在區塊內。

> 區塊間引用
>> 區塊間引用

> ### 引用其他語法
複製程式碼

區塊引用...

區塊引用...

段落只需要要在第一行加上 整個段落即引用在區塊內。

區塊間引用

區塊間引用

引用其他語法

##1.3 列表

Markdown支援有序列表和無序列表。

###1.3.1 有序列表

有序列表使用1.數字接著一個英文句點；特別注意的是在標記上使用的數字並不會影響輸出結果；列表項還可以包含多個段落，每個列表下段落都必須縮排4個空格或者1個製表符；如果需要在列表專案內引用的時候，使用 > 需要縮排。例如如下語法：

1.   item 1
3.   item 2(標記上使用的數字並不會影響輸出結果)
2.   item 3(標記上使用的數字並不會影響輸出結果)
4.   item 4
      多段文字1
      多段文字1
      >區塊引用
5.  item 5
    1.列表專案內加列表
複製程式碼
  1. item 1
  1. item 2(標記上使用的數字並不會影響輸出結果)
  2. item 3(標記上使用的數字並不會影響輸出結果)
  3. item 4 多段文字1 多段文字1

    區塊引用

  4. item 5 1.列表專案內加列表

###1.3.2 無序列表

無序列表使用 *(星號)、+(加好) 以及 -(減號)作為列表標記：

- item 1
+ item 2
* item 3
  - item 3.1
    - item 3.1.1
複製程式碼
  • item 1
  • item 2
  • item 3
    • item 3.1
      • item 3.1.1

1.4 程式碼區塊

和程式相關的寫作通常會用到程式碼區塊，如果用區塊引用排版就會和程式碼排版有差異，而我們更希望是按照原來的樣子顯示。Markdown 通過 ` 和 ``` 標籤來把程式碼區塊包起來。

在程式碼區塊裡， & 、<和>會自動轉換成HTML試題，這樣讓諸如插入範例使用的HTML原始碼更方便了。

 <div class="footer">
        © 2004 Foo Corporation
 </div>
複製程式碼

在程式碼區塊中，一般的Markdown語法不會被轉換，因此可以很容易的用Markdown語法撰寫相關語法文件。

1.5 分割線

在任意一行中用三個以上的 *、-以及_來建立分割線，行內不能有除空格外的其他內容。

1.6 特殊格式

1.6.1 粗體

粗體文字設定使用 **將目標文字包含起來。

Bold

1.6.2 斜體

斜體文字設定使用 _將目標文字包含起來。

Italics

1.6.3 刪除線

斜體文字設定使用 ~~ 將目標文字包含起來。

strikethrough

1.6.4 語法高亮

特定語法用如```js將設定超連結的文字包含起來。

grunt.initConfig({
  assemble: {
    options: {
      assets: 'docs/assets',
      data: 'src/data/*.{json,yml}',
      helpers: 'src/custom-helpers.js',
      partials: ['src/partials/**/*.{hbs,md}']
    },
    pages: {
      options: {
        layout: 'default.hbs'
      },
      files: {
        './': ['src/templates/pages/index.hbs']
      }
    }
  }
};
複製程式碼

1.7 表格

1.7.1 普通表格

表格通過 | 和 -表示。表頭需要和表內容用 - 分割，各列內容用 | 分割。注意，不需要垂直對齊。

|table1|table2|
|--------|-------|
|content1|content2|
複製程式碼
table1 table2
content1 content2

1.7.1 特殊格式表格

在表頭內容分割線結束加上 : 即表示文字靠右對齊。

|table1|table2|
|--------:|-------:|
|content1|content2|
複製程式碼
table1 table2
content1 content2

1.8 超連結

超連結通過 [ 超連結文字 ] 包含超連結文字內容，並在後緊跟 (URL) 超連結地址。

[Link](http://www.jianshu.com/u/7f8d85055cd1)
複製程式碼

當需要為超連結新增hover效果的時候，在 (URL "hoverTitle") URL後用 "" 將提示文字包含起來。

[Link](http://www.jianshu.com/u/7f8d85055cd1 "Burjal")
複製程式碼

1.9 Named Anchors

Named Anchors使能夠在相同的頁面上跳轉到指定的錨點。最常用的就是跳轉到每一個章節。

# Table of Contents
  * [Chapter 1](#chapter-1)
  * [Chapter 2](#chapter-2)
  * [Chapter 3](#chapter-3)
複製程式碼

Table of Contents

上述會跳轉到對應如下位置：

## Chapter 1 <a id="chapter-1"></a>
Content for chapter one.

## Chapter 2 <a id="chapter-2"></a>
Content for chapter one.

## Chapter 3 <a id="chapter-3"></a>
Content for chapter one.
複製程式碼

1.20 圖片

圖片的語法和超連結的語法類似，在超連結語法前加了 ! 。

![Markdown](https://user-gold-cdn.xitu.io/2017/12/16/1605d7634bc42476?w=1240&h=239&f=png&s=20553)
複製程式碼

Markdown

#二、簡書設定預設編輯器：

簡書已經支援Markdown語法編輯。 設定步驟如下：

設定

在首頁找到並進入設定。

設定常用編輯器

將常用編輯器設定為 Markdown 。

Markdown 語法入門分析到此就結束了~

附：

Grav SYNTAX

Markdown 語法說明 (簡體中文版)

Markdown: Basics(快速入門)

相關文章