有道雲筆記 - Markdown模板
附 本文的Markdown源碼鏡像:
https://github.com/yanglr/AlgoSolutions/blob/master/Youdao_Note_Markdown_Template.md
點擊”Raw”可看到源碼,歡迎fork或star~
抽空把【簡明版】有道雲筆記Markdown指南的圖片版歡迎成了Markdown,有需要的速速拿去~
什么是Markdown?Markdown是一種輕量級的「標記語言」,通常為程序員群體所用,目前它已是全球最大的技術分享網站 GitHub 和技術問答網站 StackOverFlow 的御用書寫格式。
有道雲筆記內置Markdown編輯器和使用指南,非技術類筆記用戶,千萬不要被「標記」、「語言」嚇到,Markdown的語法十分簡單,常用的標記符號不超過十個,用於日常寫作記錄綽綽有余,不到半小時就能完全掌握。
就是這十個不到的標記符號,卻能讓人優雅地沉浸式記錄,專注內容而不是糾結排版,達到「心中無塵,碼字入神」的境界。
一、利用Markdown可以做什么?
- 代碼高亮
代碼高亮
code:
@requires_authorization
def somefunc(param1='', param2=0):
'''A docstring'''
if param1 > param2: # interesting
print 'Greater'
return (param2-param1+1) or None
Class SomeClass:
pass
>>> message = '''interpreter ... prompt'''
2. 制作待辦事項To-do List
To-do List
code:
- [x] 已完成項目1
- [x] 已完成事項1
- [x] 已完成事項2
- [ ] 待辦事項1
- [ ] 待辦事項2
3. 高效繪制 流程圖、序列圖、甘特圖、表格
流程圖:
code:
graph TD
A[christmas] -->B(Go shopping)
B --> C{LEt me think}
C -->|One| D[Laptop]
C -->|Two| E[iPhone]
C -->|Three|F[Car]
序列圖:
code:
sequenceDiagram
loop every day
Alice->>John: Hello John, how are you?
John-->> Alice: Great!
end
甘特圖:
code:
gantt
dateFormat YYYY-MM-DD
title 產品計划表
section 初期階段
明確需求: 2016-03-01, 10d
section 中期階段
跟進開發: 2016-03-11, 15d
section 后期階段
走查測試: 2016-03-20, 9d
==tips==: 以上流程圖均為半角標點
表格:
表格
code:
|Item | Value | Qty |
|:------ |---------: |:--: |
|Computer | 1600 USD | 5 |
|Phone | 12 USD | 12 |
|Pipe | 12 USD | 234 |
4. 書寫數學公式
Mathematical formula
Inline math:
code:
\oint_C x^3\, dx+4y^2\,dy
2 = \left(\frac{\left(3-x\right)\times 2}{3-x}\right)
\sum_{m=1}^\infty\sum_{n=1}^\infty\frac{m^2n}{3^m\left(m3^n+n3^m\right)}
\phi_n(\kappa) = \frac{1}{4\pi^2\kappa^2}\int_0^\infty\frac{\sin(\kappa R)}{\kappa R}\frac{\partial}{\partial R}\left[R^2\frac{\partial D_n(R)}{\partial R}\right]dR
二、有道雲筆記Markdown簡明版使用指南
0. 標題
標題是每篇文章必備而且最常用的格式。
在Markdown中,如果想將一段文字定義為標題,只需要在這段文字前面加上 #,再在 # 后加一個空格即可。還可增加二、三、四、五、六級標題,總共六級,只需要增加 # ,增加一個 # ,標題字號相應降低一級。如圖:
code:
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
1. 列表
列表格式也很常用,它可以讓你的文稿變得井井有條。在 Markdown 中,你只需要在文字前面加上 - 就可以了;如果你希望是有序列表,在文字前面加上 1. 2. 3. 即可
無序列表
code:
- 列表1
- 列表1.1
- 列表1.2
- 列表2
- 列表3
有序列表
code:
1. 列表1
1. 列表1.1
2. 列表1.2
2. 列表2
3. 列表3
2. 引用
如果你需要在文稿中引用一段別處的句子,那么就要用到「引用」格式。
在引用文字前加上 > 並與文字保留一個字符的空格,即可。
引用
code:
> 記錄, 成為更好的自己。————有道雲筆記
3. 粗體和斜體
Markdown 的粗體和斜體也非常簡單:
用兩個 * 包含一段文本就是粗體的語法;
用一個 * 包含一段文本就是斜體的語法。
code:
*這是斜體*
**這是粗體**
注意: 符號與文本之間無需空格
4. 鏈接和圖片
鏈接:在 Markdown 中,插入鏈接只需要使用 [顯示文本](鏈接地址) 即可。
圖片:在 Markdown 中,插入圖片只需要使用 即可。
注:插入圖片的語法和鏈接的語法很像,只是前面多了一個 !
插入鏈接
code:
[有道雲筆記官網](http://note.youdao.com/)
插入圖片
code:

5. 分割線
分割線的語法只需要另起一行,連續輸入三個星號 * 即可分割兩段文字內容。
如圖:
分割線
code:
這是第一段內容
***
這是第二段內容
6. 表格
當你需要在Markdown文稿中鍵入表格,代碼如下:
示例參考:
表格
code:
|Item | Value | Qty |
|:------ |---------: |:--: |
|Computer | 1600 USD | 5 |
|Phone | 12 USD | 12 |
|Pipe | 12 USD | 234 |
如上7大格式是寫作文稿時最常使用的。
怎么樣,看了相關Markdown語法是不是覺得挺簡單?
當然,Markdown新手在使用不熟練的情況下,可能會忘記相關語法,也沒關系,筆記的工具欄內置了Markdown語法,方便學習與熟悉。
如,「表格」語法相對復雜,你可能忘記了,這時候,你只需要點擊編輯框上方工具欄,點選「表格」的圖標,左邊編輯區便會出現「表格」相應代碼:
然后,你只需要將代碼替換成相應文本即可,如圖:
熟悉語法之后,還是建議大家少使用輔助工具欄,盡量自己鍵入代碼,感受純文本之美。
當然,有道雲筆記的Markdown還能支持制作待辦事項,書寫流程圖、序列圖、甘特圖,書寫數學公式等,是不是夠極客,夠有逼格?
看看筆記菌用Markdown甘特圖寫的項目計划時間表:
Tips for 有道雲筆記中的 Markdown
① 實時同步預覽,所看即所得
我們將筆記編輯界面一分為二,左邊為編輯區,右邊為預覽區,兩區滾動條同步。在編輯區的操作能夠實時反映在預覽區,方便及時調整和查看最終版面效果。
② 工具欄內置Markdown語法,方便新手學習
編輯頁面頂端的工具欄有對應代碼,如果你是一個不熟悉Markdown語法的新手,可以先嘗試用工具欄輔助操作。也可以在網上搜索「Markdown語法指南」進行學習。
當然,如果你覺得工具欄太打擾,點擊下方分界條即可隱藏工具欄,切換到極簡編輯環境。
③ 實時雲端保存
Markdown模式繼承了有道雲筆記的優良傳統,你每一次擊鍵的內容都會實時保存在雲端,無需擔心瀏覽器崩潰、設備沒電、突然斷網等情況。對於寫作者來說,更是再也不用擔心因為各種原因痛失文稿的情況了。
④ 界面大小可點擊分界條調整。
點擊“1”處,工具欄收起;
點擊“2”處,右側預覽區收起。
在有道雲筆記 - Markdown模式下的顯示效果:
http://note.youdao.com/noteshare?id=6ec3c87769048bf2ba7df068f377e5a3&sub=131D97485A5E4AE5A1E2CBC0CF3E679C
附 本文的markdown源代碼
### 有道雲筆記 - Markdown模板
附 本文的Markdown源碼:
<https://github.com/yanglr/AlgoSolutions/blob/master/Youdao_Note_Markdown_Template.md>
點擊"Raw"可看到源碼,歡迎fork或star~
<br>
[toc]
<font size=4></font>
抽空把[【簡明版】有道雲筆記Markdown指南](http://note.youdao.com/iyoudao/?p=2411)的圖片版歡迎成了Markdown,有需要的速速拿去~

什么是Markdown?Markdown是一種輕量級的「標記語言」,通常為程序員群體所用,目前它已是全球最大的技術分享網站 GitHub 和技術問答網站 StackOverFlow 的御用書寫格式。
**有道雲筆記內置Markdown編輯器和使用指南,非技術類筆記用戶,千萬不要被「標記」、「語言」嚇到,Markdown的語法十分簡單,常用的標記符號不超過十個,用於日常寫作記錄綽綽有余,不到半小時就能完全掌握。**
就是這十個不到的標記符號,卻能讓人**優雅地沉浸式記錄,專注內容而不是糾結排版**,達到「心中無塵,碼字入神」的境界。
# 一、利用Markdown可以做什么?
1. 代碼高亮

### 代碼高亮
```python
@requires_authorization
def somefunc(param1='', param2=0):
'''A docstring'''
if param1 > param2: # interesting
print 'Greater'
return (param2-param1+1) or None
Class SomeClass:
pass
>>> message = '''interpreter
... prompt'''
2. 制作待辦事項To-do List

<div class="se-preview-section-delimiter"></div>
### To-do List
- [x] 已完成項目1
- [x] 已完成事項1
- [x] 已完成事項2
- [ ] 待辦事項1
- [ ] 待辦事項2
3. 高效繪制 流程圖、序列圖、甘特圖、表格
<div class="se-preview-section-delimiter"></div>
### 流程圖:

graph TD
A[christmas] -->B(Go shopping)
B --> C{LEt me think}
C -->|One| D[Laptop]
C -->|Two| E[iPhone]
C -->|Three|F[Car]
<div class="se-preview-section-delimiter"></div>
### 序列圖:

sequenceDiagram
loop every day
Alice->>John: Hello John, how are you?
John-->> Alice: Great!
end
<div class="se-preview-section-delimiter"></div>
### 甘特圖:

gantt
dateFormat YYYY-MM-DD
title 產品計划表
section 初期階段
明確需求: 2016-03-01, 10d
section 中期階段
跟進開發: 2016-03-11, 15d
section 后期階段
走查測試: 2016-03-20, 9d
**==tips==: 以上流程圖均為半角標點**
<div class="se-preview-section-delimiter"></div>
### 表格:

<div class="se-preview-section-delimiter"></div>
### 表格
|Item | Value | Qty |
|:------ |---------: |:--: |
|Computer | 1600 USD | 5 |
|Phone | 12 USD | 12 |
|Pipe | 12 USD | 234 |
4. 書寫數學公式

<div class="se-preview-section-delimiter"></div>
## Mathematical formula `$y = x^2$`
Inline math: `$\dfrac{\tfrac{1}{2}[1-(\tfrac{1}{2})^n]}{1 - \tfrac{1}{2}} = s_n$`
Math block:
<div class="se-preview-section-delimiter"></div>
```math
\oint_C x^3\, dx+4y^2\,dy
2 = \left(\frac{\left(3-x\right)\times 2}{3-x}\right)
\sum_{m=1}^\infty\sum_{n=1}^\infty\frac{m^2n}{3^m\left(m3^n+n3^m\right)}
\phi_n(\kappa) = \frac{1}{4\pi^2\kappa^2}\int_0^\infty\frac{\sin(\kappa R)}{\kappa R}\frac{\partial}{\partial R}\left[R^2\frac{\partial D_n(R)}{\partial R}\right]dR
# 二、有道雲筆記Markdown簡明版使用指南
**0. 標題**
標題是每篇文章必備而且最常用的格式。
在Markdown中,如果想將一段文字定義為標題,只需要在這段文字前面加上 #,再在 # 后加一個空格即可。還可增加二、三、四、五、六級標題,總共六級,只需要增加 # ,增加一個 # ,標題字號相應降低一級。如圖:

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
**1. 列表**
列表格式也很常用,它可以讓你的文稿變得井井有條。在 Markdown 中,你只需要在文字前面加上 - 就可以了;如果你希望是有序列表,在文字前面加上 1. 2. 3. 即可
#### 無序列表
- 列表1
- 列表1.1
- 列表1.2
- 列表2
- 列表3
- #### 有序列表
1. 列表1
1. 列表1.1
2. 列表1.2
2. 列表2
3. 列表3
**2. 引用**
如果你需要在文稿中引用一段別處的句子,那么就要用到「引用」格式。
在引用文字前加上 > 並與文字保留一個字符的空格,即可。

######引用
> 記錄, 成為更好的自己。————有道雲筆記
**3. 粗體和斜體**
Markdown 的粗體和斜體也非常簡單:
用兩個 * 包含一段文本就是粗體的語法;
用一個 * 包含一段文本就是斜體的語法。

*這是斜體*
**這是粗體**
#### 注意: 符號與文本之間無需空格
**4. 鏈接和圖片**
鏈接:在 Markdown 中,插入鏈接只需要使用 [顯示文本](鏈接地址) 即可。
圖片:在 Markdown 中,插入圖片只需要使用 即可。
注:插入圖片的語法和鏈接的語法很像,只是前面多了一個 !

#### 插入鏈接
[有道雲筆記官網](http://note.youdao.com/)
#### 插入圖片

**5. 分割線**
分割線的語法只需要另起一行,連續輸入三個星號 *** 即可分割兩段文字內容。
如圖:

#### 分割線
這是第一段內容
***
這是第二段內容
**6. 表格**
當你需要在Markdown文稿中鍵入表格,代碼如下:

示例參考:
### 表格
|Item | Value | Qty |
|:------ |---------: |:--: |
|Computer | 1600 USD | 5 |
|Phone | 12 USD | 12 |
|Pipe | 12 USD | 234 |
**如上7大格式是寫作文稿時最常使用的。**
怎么樣,看了相關Markdown語法是不是覺得挺簡單?
當然,Markdown新手在使用不熟練的情況下,可能會忘記相關語法,也沒關系,筆記的工具欄內置了Markdown語法,方便學習與熟悉。
如,「表格」語法相對復雜,你可能忘記了,這時候,你只需要點擊編輯框上方工具欄,點選「表格」的圖標,左邊編輯區便會出現「表格」相應代碼:

然后,你只需要將代碼替換成相應文本即可,如圖:

熟悉語法之后,還是建議大家少使用輔助工具欄,盡量自己鍵入代碼,感受純文本之美。
當然,有道雲筆記的Markdown還能支持制作待辦事項,書寫流程圖、序列圖、甘特圖,書寫數學公式等,是不是夠極客,夠有逼格?
看看筆記菌用Markdown甘特圖寫的項目計划時間表:

## Tips for 有道雲筆記中的 Markdown
**① 實時同步預覽,所看即所得**
我們將筆記編輯界面一分為二,左邊為編輯區,右邊為預覽區,兩區滾動條同步。在編輯區的操作能夠實時反映在預覽區,方便及時調整和查看最終版面效果。
**② 工具欄內置Markdown語法,方便新手學習**
編輯頁面頂端的工具欄有對應代碼,如果你是一個不熟悉Markdown語法的新手,可以先嘗試用工具欄輔助操作。也可以在網上搜索「Markdown語法指南」進行學習。
當然,如果你覺得工具欄太打擾,點擊下方分界條即可隱藏工具欄,切換到極簡編輯環境。
**③ 實時雲端保存**
Markdown模式繼承了有道雲筆記的優良傳統,你每一次擊鍵的內容都會實時保存在雲端,無需擔心瀏覽器崩潰、設備沒電、突然斷網等情況。對於寫作者來說,更是再也不用擔心因為各種原因痛失文稿的情況了。
**④ 界面大小可點擊分界條調整。**
點擊“1”處,工具欄收起;
點擊“2”處,右側預覽區收起。

**在有道雲筆記 - Markdown模式下的顯示效果:**
<http://note.youdao.com/noteshare?id=6ec3c87769048bf2ba7df068f377e5a3&sub=131D97485A5E4AE5A1E2CBC0CF3E679C>