markdown 入門

# markdown quickstart
---
[TOC]

---

## 1.introduction
  markdown的最初設計是讓人專一寫做,又讓輸出內容易於閱讀。它適用於典型應用場景,如寫博客,說明文檔等一切要求書寫內容大且快速造成易於閱讀的文檔。
 
  對比HTML,wiki, Markdown是一種輕量級的標記語言,語法簡單,能夠排出簡潔的表現界面,適用於網絡的書寫語言,且支持表格,代碼塊,目錄,連接等
 
 
###markdown優勢
- 純文本
- 快速格式化
- 書寫簡單,易學易懂,且源碼易閱讀
- 利用導出其它流行格式html,pdf等
- 擴展工具免費且豐富

###markdown缺點
- 不支持更豐富的格式化
- 未標準化

##2.markdown 快速入門語法

###1. heading
```
  #h1         <h1></h1>
  ##h2        <h2></h2>
  ###h3       <h3></h3>  
```

###2. bold,Italic & strikethrough
*Italic*  
**bold**  
***bold&Italic***  
~~刪除線~~

###3. list
也能夠縮進,最多 3 個空格,項目標記後面則必定要接着至少一個空格或製表符
列表支持嵌套

- unorder list1
- unorder list2
- unorder list3
* unorder list4
* unorder list5
+ unorder list6



1. order list 1
2. order list 2
3. order list 3

###5. table
header1 | header2 | header3
---     |-------: |:---:
foo     | foo     | foo
bar     | bar     | bar
baz     | baz     | baz

| Tables        | Are           | Cool  |
| :-------------: |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |


### 6. todo list
- []  todo1
- [x]  todo2
- [x]  todo3


###7. blockquote
 
```
<blockquote>
it can be used to highlight your code
使用多個>,能夠將<blockquote>嵌套,且<blockquote>內能夠使用其它markdown語法
line 1
line 2
line 3
```
   
   
> This is the first level of quoting.
>
> `inline code`
> `sum = b + c`   <code> inline code  </code>    行內代碼
> `mkdir tickets`  then ` cd tickets`
>  header line test
>
> - unorder list1
> - unorder list2
> > This is nested blockquote. 引用嵌套
>
> Back to the first level.

###8. other
   --- 分頁線  <hr />
   
   空白行表示另起一個段落
   
   <hr>
   
   行尾兩個以上空格+Enter   <br /> markdown段內強制換行  
 
###9.兼容HTML
1. 不在 Markdown 涵蓋範圍以內的標籤,均可以直接在文檔裏面用 HTML 撰寫
2. 一些HTML的區塊元素,如`<div><table><pre><p>`等標籤,必須在先後加上空行與其它內容區隔開
3. HTML的開始標籤與結尾標籤不能用製表符或空格來縮進
4. 在 HTML 區塊標籤間的 Markdown 格式語法將不會被處理
5. HTML 的區段(行內)標籤如 `<span>、<cite>、<del> `能夠在 Markdown 的段落、列表或是標題裏隨意使用

<p>Here is an example of AppleScript:</p>

###10.特殊字符自動轉換< & \
HTML中的兩個字符(< &)須要特別處理,<用於標籤,&用於標記HTML實體。 markdown能夠讓人天然地書寫字符,它會根據語境自動決定是否轉換:  
markdown code 範圍內,不管是行內仍是區塊,< 和 & 都必定會被轉換成 HTML 實體
markdown使用\來轉義,表示文本中markdown符號




## markdown editor
[Mahua](http://mahua.jser.me/)
[maxiang](https://maxiang.io/)
[mou](http://25.io/mou/)
[gedit-markdown](https://github.com/jpfleury/gedit-markdown)
[markdown 語法說明](http://wowubuntu.com/markdown/index.html#autoescape)


html

相關文章
相關標籤/搜索