[TOC=2,3]
>[danger] 為了確保編輯功能的完整體驗，請盡量避免使用包括IE在內的瀏覽器進行在線編輯。
看云使用了獨立開發的`MarkDown`編輯器，其語法規范兼容標準的`MarkDown`語法，基本用法介紹如下：
## H1~H6
選中內容后按編輯器工具欄上的  或者使用 `CTRL+1` ~ `CTRL+6` 快捷鍵。 示例效果：
~~~
# H1文字
## H2文字
### H3文字
#### H4文字
##### H5文字
###### H6文字
~~~
## 粗體
選擇內容后按編輯器工具欄上的  或者使用 `CTRL+B` 快捷鍵。
示例效果：
~~~
**粗體內容**
~~~
**粗體內容**
## 斜體
選擇內容后按編輯器工具欄上的  或者使用 `CTRL+I` 快捷鍵。
示例效果：
~~~
_斜體內容_
~~~
*斜體內容*
## 刪除線
選中內容后按編輯器工具欄上的  按鈕或者使用 `CTRL+SHIFT+X` 快捷鍵。
示例效果：
```
~~刪除內容~~
```
~~刪除內容~~
## 無序列表
選擇多行內容后按編輯器工具欄上的  或者使用 `CTRL+ALT+U` 快捷鍵。
示例效果：
~~~
* 列表項1
* 列表項2
* 列表項3
* 列表項4
~~~
* 列表項1
* 列表項2
* 列表項3
* 列表項4
支持使用多級列表：
~~~
* 列表項1
* 列表項2
* 子列表項1
* 子列表項2
~~~
* 列表項1
* 列表項2
* 子列表項1
* 子列表項2
## 有序列表
選擇多行內容后按編輯器工具欄上的  或者使用 `CTRL+ALT+O` 快捷鍵。
示例效果：
~~~
1. 列表項1
2. 列表項2
3. 列表項3
4. 列表項4
~~~
1. 列表項1
2. 列表項2
3. 列表項3
4. 列表項4
支持使用多級列表：
~~~
1. 列表項1
2. 列表項2
1. 子列表項1
2. 子列表項2
~~~
1. 列表項1
2. 列表項2
1. 子列表項1
2. 子列表項2
## 任務列表
可以定義任務列表，直接點擊編輯器工具欄的  或者使用 `CTRL+ALT+T`快捷鍵，并且一樣支持多級，格式如下：
~~~
* [ ] 代辦事項1
* [ ] 代辦事項2
* [x] 完成事項3
* [x] 完成事項4
~~~
* [ ] 代辦事項1
* [ ] 代辦事項2
* [x] 完成事項3
* [x] 完成事項4
## 鏈接
選擇要添加鏈接的內容后按編輯器工具欄上的  或者使用 `CTRL+L` 快捷鍵。
示例效果：
~~~
[鏈接文字](http://www.hmoore.net)
~~~
[鏈接文字](http://www.hmoore.net)
>[info] 還有一種簡單的方式可以直接輸入一個規范的鏈接地址，會自動識別為鏈接，而無需使用markdown鏈接規范。
~~~
看云的網址是：http://www.hmoore.net
~~~
看云的網址是：[http://www.hmoore.net](http://www.hmoore.net)
> 網址前后加上空格可以避免混淆
上述寫法中鏈接地址中不能含有括號，如果你的鏈接地址中帶有括號的話，可以使用下面的方式：
> ~~~
> [鏈接文字] [1]
> 這里可以添加任何內容
> 然后在頁面的任意位置添加如下：
> [1]: http://www.hmoore.net/test_address
> ~~~
如果要添加內鏈地址，可以直接把鏈接地址寫成版本庫的文件地址，例如：
~~~
[寫作規范](寫作規范.md)
~~~
[寫作規范](%E5%BB%BA%E8%AE%AE%E8%A7%84%E8%8C%83.md)
支持直接拖動左邊的目錄當當前頁面的光標位置直接插入。
## 腳注
可以給內容添加腳注功能，例如：
~~~
看云是一個文檔寫作[^write]和托管平臺[^platform]。
// 中間可以添加其他內容
[^write]: 寫作格式采用Markdown格式，支持版本和多人寫作。
[^platform]: 發布的文檔可以直接在平臺閱讀、分享和私有存儲，并支持付費閱讀。
~~~
>[info] 通常可以把腳注的內容解釋統一放到頁面最后。
腳注的鏈接效果如下：
看云是一個文檔寫作[^write]和托管平臺[^platform]。
## 圖片
有二種方式可以添加圖片：
1. 點擊編輯器工具欄上的  或者使用 `CTRL+ALT+Y` 快捷鍵 彈出文件上傳選擇框后點擊上傳需要的圖片文件即可。
2. 復制網頁上的圖片或者直接截屏操作后在編輯器中進行粘貼操作，圖片也會自動上傳到當前光標位置顯示，如果你選擇了某段文字后粘貼的話，該段內容會作為圖片的ALT信息顯示。
所以，在創作文檔的時候，你可以根據你的需要采用不同的方式上傳圖片。
> 關于設置圖片大小：默認圖片是自適應顯示的，如果需要設置圖片文件的大小可以使用
~~~
~~~
示例：
> 如果上傳了非圖片文件，將無法顯示
## 外部圖床
支持使用外部云存儲來保存圖片，這樣不會占用看云本身的文檔空間，但需要注意會影響打包的性能（如果外部圖片較多的情況下 可能會打包失敗），但在線閱讀不受任何影響。
打開文檔設置->插件管理后，添加云圖片插件
刷新頁面后再次打開文檔設置頁面，在插件設置找到云圖片
在插件設置頁面選擇七牛或者又拍云，然后設置相關的key（參考七牛或者又拍云的文檔），點擊應用后就可以把圖片直接傳到指定的云存儲了。
>[danger] 注意：如果安裝了云圖片插件后必須及時設置好存儲參數，否則會導致所有圖片都不能上傳。
## 行內代碼
選擇代碼段落后后按編輯器工具欄上的  或者使用 `CTRL+E` 快捷鍵。
示例效果：
~~~
行內代碼 `define('APP_DEBUG', false);`
~~~
行內代碼 `define('APP_DEBUG', false);`
## 代碼段
選擇工具欄的按鈕或者使用 `CTRL+SHIFT+E` 快捷鍵。
~~~
代碼段：
```
// 系統常量定義
defined('THINK_PATH') or define('THINK_PATH', __DIR__.'/');
defined('APP_PATH') or define('APP_PATH', dirname($_SERVER['SCRIPT_FILENAME']).'/');
defined('APP_STATUS') or define('APP_STATUS', ''); // 應用狀態 加載對應的配置文件
defined('APP_DEBUG') or define('APP_DEBUG', false); // 是否調試模式
```
~~~
>[info] 注意：多行代碼標簽前面不能有空白，后面必須換行。
代碼段：
```
// 系統常量定義
defined('THINK_PATH') or define('THINK_PATH', __DIR__.'/');
defined('APP_PATH') or define('APP_PATH', dirname($_SERVER['SCRIPT_FILENAME']).'/');
defined('APP_STATUS') or define('APP_STATUS', ''); // 應用狀態 加載對應的配置文件
defined('APP_DEBUG') or define('APP_DEBUG', false); // 是否調試模式
```
可以指定代碼使用的語言，例如：
~~~
多行代碼：
```php
// 系統常量定義
defined('THINK_PATH') or define('THINK_PATH', __DIR__.'/');
defined('APP_PATH') or define('APP_PATH', dirname($_SERVER['SCRIPT_FILENAME']).'/');
defined('APP_STATUS') or define('APP_STATUS', ''); // 應用狀態 加載對應的配置文件
defined('APP_DEBUG') or define('APP_DEBUG', false); // 是否調試模式
```
~~~
## 分割線
點擊編輯器工具欄上的  或者使用 `CTRL+H` 用于插入一條分割線。
示例效果：
~~~
* * * * *
~~~
*****
## 引用
選擇內容后按編輯器工具欄上的  或者使用 `CTRL+Q` 快捷鍵。
示例效果：
~~~
> 這是一段引用內容文字
> 這是第二行引用內容文字
> 這是第三行引用內容文字
~~~
> 這是一段引用內容文字這是第二行引用內容文字這是第三行引用內容文字
在引用內容中還可以使用部分其他的格式，例如：
~~~
> 這是一段引用內容文字 **粗體內容**
> 這是第二行引用內容文字 _斜體內容_
> 這是第三行引用內容文字 `單行代碼`
> [這是一個鏈接](http://www.hmoore.net)
~~~
> 這是一段引用內容文字 **粗體內容**這是第二行引用內容文字 *斜體內容*這是第三行引用內容文字 `單行代碼`[這是一個鏈接](http://www.hmoore.net)
支持多級引用，例如：
~~~
> 引用內容
>
> > 子引用內容
> > 子引用內容
~~~
> 引用內容
> > 子引用內容
> > 子引用內容
**引用樣式支持**
可以通過引用樣式對引用內容進行特別的強調，目前支持四種引用樣式，分別是：
info：
~~~
>[info] 這里是**提示信息**
>通常用于一些提醒事項
~~~
>[info] 這里是**提示信息**
> 通常用于一些提醒事項
warning：
~~~
>[warning] 這里是**警告信息**
>通常用于一些警告事項
~~~
>[warning] 這里是**警告信息**
> 通常用于一些警告事項
success：
~~~
>[success] 這里是**成功信息**
>通常用于一些成功提示
~~~
>[success] 這里是**成功信息**
> 通常用于一些成功提示
danger：
~~~
>[danger] 這里是**危險信息**
>需要引起特別的注意
~~~
>[danger] 這里是**危險信息**
> 需要引起特別的注意
## 段落排版
支持段落的居左、居中和居右排版，選中段落內容后點擊工具欄上面的  按鈕就可以對段落進行居左（`CTRL+ALT+L`）、居中（`CTRL+ALT+E`）和居右（`CTRL+ALT+R`）排版了。
并且也支持圖片和引用段落的排版。
示例：
~~~txt
這是一個居左的段落
:-: 這是一個居中的段落
--: 這是一個居右的段落
>[info] --: 這里是居右的引用內容
:-: 
:-: 圖片居中
~~~
這是一個居左的段落
:-: 這是一個居中的段落
--: 這是一個居右的段落
>[info] --: 這里是居右的引用內容
:-: 
:-: 圖片居中
## 表格
點擊工具欄上的  按鈕插入表格的單元項。
示例效果：
~~~
| 編號 | 產品 | 描述 |
|---|---|---|
| 1 | ThinkPHP | 開源WEB應用框架 |
| 2 | OneThink | 開源內容管理框架 |
| 3 | 看云 | 文檔托管平臺 |
~~~
| 編號 | 產品 | 描述 |
| --- | --- | --- |
| 1 | ThinkPHP | 開源WEB應用框架 |
| 2 | OneThink | 開源內容管理框架 |
| 3 | 看云 | 文檔托管平臺 |
支持對單元列設置對齊方式，例如：
~~~
| 編號（居右對齊） | 產品（居中對齊） | 描述（居左對齊） |
| ---: | :---: | :--- |
| 1 | ThinkPHP | 開源WEB應用框架 |
| 2 | OneThink | 開源內容管理框架 |
| 3 | 看云 | 文檔托管平臺 |
~~~
| 編號（居右對齊） | 產品（居中對齊） | 描述（居左對齊） |
| --: | :-: | --- |
| 1 | ThinkPHP | 開源WEB應用框架 |
| 2 | OneThink | 開源內容管理框架 |
| 3 | 看云 | 文檔托管平臺 |
> 注：markdown規范不支持復雜的表格，如果需要，可以自行粘貼表格的HTML代碼，可以直接顯示。
## 數學公式
看云支持在內容中插入數學公式，并支持`Katex`和`MathJax`，在編輯模式下面打開右上角的插件管理，添加數學公式插件：
然后在插件設置里面找到數學公式后安裝
并支持設置顯示引擎（目前支持`Katex`和`MathJax`）
然后，你就可以直接在編輯區輸入公式定義，例如：
單行公式：
~~~
`$ c = \pm\sqrt{a^2 + b^2} $`
~~~
支持多行的寫法 多行的公式會居中顯示 如：
~~~
```[tex]
f(x) = \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x} \,d\xi
```
~~~
實際效果如圖：
## 流程圖和時序圖
支持在文檔中直接插入和編輯流程圖及時序圖，只需要使用`flow`和`sequence`插件，打開文檔設置->插件管理安裝相應的插件，添加：
然后在文檔中使用下面的方式添加流程圖和時序圖即可。
流程圖：
~~~
```[flow]
st=>start: Start:>http://www.google.com[blank]
e=>end:>http://www.google.com
op1=>operation: My Operation
sub1=>subroutine: My Subroutine
cond=>condition: Yes
or No?:>http://www.google.com
io=>inputoutput: catch something...
st->op1->cond
cond(yes)->io->e
cond(no)->sub1(right)->op1
```
~~~
效果如圖所示：
時序圖：
~~~
```[sequence]
Title: Here is a title
A->B: Normal line
B-->C: Dashed line
C->>D: Open arrow
D-->>A: Dashed open arrow
```
~~~
實際效果如圖：
## 音頻播放
可以在文檔內容里面播放音頻,首先安裝音頻播放插件
安裝完成后就可以點擊編輯工具欄的音頻播放按鈕插入音頻
## 視頻播放
可以支持插入視頻內容，如果是優酷視頻可以使用`youku`插件，添加優酷視頻插件：
刷新頁面后可以在工具欄看到  按鈕，點擊彈出
把你的優酷視頻地址或者ID直接粘貼過來就可以了，如果設置了視頻密碼的話，還可以設置免密碼播放（需要用戶開通視頻私密托管服務）。
如果你需要插入外部視頻地址進行播放,可以安裝視頻播放插件
安裝完成后,點擊編輯工具欄上的視頻按鈕  即可插入視頻
可以支持H5支持的所有視頻格式。
## 轉義符
如果你需要輸入一些特殊的符合，但又不希望被用于Markdown標簽解析，那么可以使用轉義符，Markdown支持以下這些符號前面加上反斜杠來幫助插入普通的符號：
~~~
\ 反斜線
` 反引號
* 星號
_ 底線
{} 花括號
[] 方括號
() 括弧
# 井字號
+ 加號
- 減號
. 英文句點
! 驚嘆號
~~~
例如：
~~~
\*看云文檔托管平臺\*
\_看云文檔托管平臺\_
\#\# 看云文檔托管平臺
~~~
\*看云文檔托管平臺\*
\_看云文檔托管平臺\_
\## 看云文檔托管平臺
## 章節導航
可以在當前內容中插入（當前內容頁的）章節導航，點擊編輯器工具欄上的  按鈕會在光標位置插入 `[TOC]` ，在右側預覽區就可以看到會自動提取當前內容的目錄結構。
> 注意：`[TOC]` 后面必須增加一個空行才能正確顯示目錄結構。
默認情況下 `[TOC]` 在頁面解析的時候會自動提取當前頁面中的所有`H1~H6`的內容作為目錄展示（包含層次關系），如圖所示：
如果你希望定制目錄的層級顯示，例如只希望提取部分內容作為目錄顯示，可以使用：
~~~
[TOC=2] // 提取H1到H2的內容顯示
[TOC=3] // 提取H1到H3的內容顯示
[TOC=2,3] // 提取H2到H3的內容顯示
~~~
## 撤銷和重做
在編輯內容的過程中可以使用`CTRL+Z`和`CTRL+Y`快捷鍵或者點擊編輯器工具欄上的  進行撤銷和重做操作。
## 全文預覽
文檔在沒有發布之前，其它用戶是無法閱讀的，但作者或者文檔成員中具有編輯以上權限的用戶（包括創始人、管理員和編輯）可以進行預覽操作。
點擊右上角的全文預覽按鈕 可以進行和最終閱讀效果一致的全文預覽。
## 編輯器設置
在編輯器界面的右下角有一個設置按鈕  ，點擊該按鈕可以設置是否顯示預覽和目錄欄。如果你的分辨率比較低，可以設置關閉自動預覽顯示，然后在寫完后使用右上角的全文預覽。
可以點擊  在MD編輯器和可視化編輯器之間切換。后面我們會單獨介紹可視化編輯模式。
## 同步內容
編輯過程中不需要進行保存操作，系統會自動保存到該文檔的暫存區，只有在點擊同步操作的時候才會實際提交到版本庫，如果需要同步內容，可以隨時點擊編輯器工具欄上的  。
默認情況下該按鈕呈灰色狀態 ，當有內容更新后，會自動顯示為  說明這個時候可以進行同步操作。
[^write]: 寫作格式采用Markdown格式，支持版本和多人寫作。
[^platform]: 發布的文檔可以直接在平臺閱讀、分享和私有存儲，并支持付費閱讀。
- 關于看云
- 遷移通知
- 注冊登錄
- 文檔寫作
- 創建文檔
- 封面圖片
- 文檔操作
- 目錄操作
- 編輯器
- 可視化編輯
- 寫作規范
- 文檔設置
- 私有轉換
- 刪除文檔
- 文檔派生
- 發布文檔
- 文檔還原
- 離線寫作
- 分享文檔
- API 文檔
- 個性化
- 插件擴展
- 樣式定義
- 綁定域名
- 導航定義
- 私有文檔
- 導入文檔
- 從GIT倉庫構建
- 導出文檔
- 文檔轉讓
- 文檔定價
- 廣場推薦
- 空間升級
- 文檔協作
- 添加成員
- 創建團隊
- 創建企業
- 釘釘接入
- 企業微信接入
- 快捷鍵
- 常見問題
- 為啥文檔發布以后仍然不能正常訪問
- 編輯保存了為什么閱讀看不到
- 如何給文檔增加代碼高亮顯示
- 如何設置字體顏色
- 如何生成復雜（跨行跨列）的表格
- 為啥章節導航無法正常顯示
- 為什么創建文檔總是提示過于頻繁
- kindle設置
- 發布后圖片不顯示
- 為什么目錄變成空的了
- 如何調整目錄排序
- 為什么右側的預覽延遲嚴重
- 更換了封面圖片后為啥沒有生效
- 為什么我的付費文檔上架審核拒絕了
- 如何去除文檔中的看云版權標識
- 從Git導入的文檔為什么沒法閱讀
- 看云和石墨及語雀的主要區別是什么？
- 在微信購買的文檔 如何在網站閱讀
- 看云的內容文字太小怎么辦
- 為什么分享的公開文檔閱讀的時候提示需要登錄
- 為什么文檔無法同步？
- 為什么購買的文檔看不到了
- 文檔超出大小應該如何擴容
- 如何給文檔添加頂部導航
- 為什么我刪除了文檔里面的圖片空間還是沒減少
- 文檔發布為什么那么慢
- 導出PDF失敗
- 更新日志
- 用戶條款
- 推薦獎勵計劃
- 推廣素材