Markdown快速入門

什麼是Markdown

Markdown是一種輕量級標記語言，可使用它向純文本文檔添加格式化元素。Markdown由John Gruber於2004年建立，如今是世界上最流行的標記語言之一。
使用Markdown與使用所見即所得編輯器是不一樣的。在Microsoft Word這樣的應用程序中，單擊按鈕來格式化單詞和短語，這些更改將當即可見。Markdown不是這樣的。建立Markdown格式的文件時，將Markdown語法添加到文本中，以指示哪些單詞和短語看起來應該不一樣。
例如，要表示一個標題，能夠在它前面添加一個數字符號(例如# 標題一)。或者，要使一個短語加粗，能夠在它的先後加上兩個星號(例如，**這是個粗體**)。可能須要一段時間來適應文本中的標記語法，特別是若是你已經習慣了所見即所得的應用程序。

可使用文本編輯器應用程序向純文本文件添加標記格式元素。或者，也可使用macOS、Windows、Linux、iOS和Android操做系統的衆多Markdown應用程序之一。還有一些基於web的應用程序專門爲用Markdown編寫而設計。
根據使用的應用程序，可能沒法實時預覽格式化的文檔。可是不要緊。根據Gruber的說法，Markdown語法被設計爲可讀且不突現的，所以即便沒有呈現Markdown文件中的文本，也能夠讀取。
Markdown格式化語法的首要設計目標是使其儘量可讀。其思想是，標記格式的文檔應該按原樣(即純文本)發佈，而不是看起來像用標記或格式說明進行了標記。

基本語法

這些是John Gruber的原始設計文檔中概述的元素。全部的標記應用程序都支持這些元素。

元素	Markdown語法	HTML	顯示效果
標題	# 標題一 ## 標題二 ### 標題三	<h1>標題一</h1> <h2>標題二</h2> <h3>標題三</h3>	標題一 標題二 標題三
粗體	**粗體文本**	<strong>粗體文本</strong>	粗體文本
斜體	*斜體文本*	<em>斜體文本</em>	斜體文本
引用	> 引用文本	<blockquote>引用文本</blockquote>	引用文本
有序列表	1. 第一項 2. 第二項 3. 第三項	<ol> <li>第一項</li> <li>第二項</li> <li>第三項</li> </ol>	第一項 第二項 第三項
無序列表	- 第一項 - 第二項 - 第三項	<ul> <li>第一項</li> <li>第二項</li> <li>第三項</li> </ul>	第一項 第二項 第三項
代碼	`code`	<code>code</code>	code
水平線	---		---
連接	[百度](https://www.baidu.com)	<a href="https://www.baidu.com">百度</a>	百度
圖像		<img src="image.jpg" alt="提示文字">

擴展語法

這些元素經過添加附加功能擴展了基本語法。並非全部的標記應用程序都支持這些元素。

元素	Markdown語法	HTML	顯示效果
表格	語法| 描述| | ----------- | ----------- | | 語法一 | 說明1 | | 語法二 | 說明二 |	<table> <tr> <th>語法</th><th>描述</th> </tr> <tr> <td>語法一</td><td>說明一</td> </tr> <tr> <td>語法二</td><td>說明二</td> </tr> </table>	語法 描述 語法一 說明一 語法二 說明二
代碼塊	``` {"firstName": "John", "lastName": "Smith", "age": 25} ```	<code> {"firstName": "John", "lastName": "Smith", "age": 25} </code>	{"firstName": "John", "lastName": "Smith", "age": 25}
註解	這是個帶註解的名字[^1] [^1]: 這裏寫註解.	這是個帶註解的名字<sup id="fnref:1"> <a href="#fn:1" class="footnote">1</a></sup>	這是個帶註解的名字1
標題編號	### 個人標題 {#custom-id}		效果請參考官網
定義列表	term : definition	<dl><dt>term</dt><dd>definition</dd></dl>	term definition
刪除項	~~我要加刪除線~~	<del>我要加刪除線</del>	我要加刪除線
任務列表	- [x] 這是第一項 - [ ] 這是第二項 - [ ] 這是第三項		效果請參考官網

參考文檔

官方文檔快速入門

基本語法詳細參考

擴展語法詳細參考

這個是1的註解↩