編輯器 · 看云新手指導

* [H1~H6](http://help.kancloud.cn/41501#H1H6_6) * [粗體](http://help.kancloud.cn/41501#_21) * [斜體](http://help.kancloud.cn/41501#_32) * [刪除線](http://help.kancloud.cn/41501#_43) * [無序列表](http://help.kancloud.cn/41501#_55) * [有序列表](http://help.kancloud.cn/41501#_86) * [任務列表](http://help.kancloud.cn/41501#_117) * [鏈接](http://help.kancloud.cn/41501#_133) * [腳注](http://help.kancloud.cn/41501#_173) * [圖片](http://help.kancloud.cn/41501#_193) * [外部圖床](http://help.kancloud.cn/41501#_216) * [行內代碼](http://help.kancloud.cn/41501#_232) * [代碼段](http://help.kancloud.cn/41501#_244) * [分割線](http://help.kancloud.cn/41501#_284) * [引用](http://help.kancloud.cn/41501#_296) * [段落排版](http://help.kancloud.cn/41501#_378) * [表格](http://help.kancloud.cn/41501#_412) * [數學公式](http://help.kancloud.cn/41501#_450) * [流程圖和時序圖](http://help.kancloud.cn/41501#_481) * [視頻](http://help.kancloud.cn/41501#_526) * [轉義符](http://help.kancloud.cn/41501#_538) * [章節導航](http://help.kancloud.cn/41501#_569) * [撤銷和重做](http://help.kancloud.cn/41501#_587) * [全文預覽](http://help.kancloud.cn/41501#_591) * [編輯器設置](http://help.kancloud.cn/41501#_597) * [同步內容](http://help.kancloud.cn/41501#_605) >[danger] 為了確保編輯功能的完整體驗，請盡量避免使用包括IE和Edge在內的瀏覽器進行在線編輯。看云使用了獨立開發的`MarkDown`編輯器，其語法規范兼容標準的`MarkDown`語法，基本用法介紹如下： ## H1~H6 選中內容后按編輯器工具欄上的![](https://box.kancloud.cn/a35bf8815366c789bb804e06ad2bb8b3_144x34.png)或者使用`CTRL+1`~`CTRL+6`快捷鍵。示例效果： ~~~ # H1文字 ## H2文字 ### H3文字 #### H4文字 ##### H5文字 ###### H6文字 ~~~ ![](http://box.kancloud.cn/2015-05-19_555b342f727ca.png) ## 粗體選擇內容后按編輯器工具欄上的![](https://box.kancloud.cn/c7fe0624364675d738556b792597ca92_37x34.png)或者使用`CTRL+B`快捷鍵。示例效果： ~~~ **粗體內容** ~~~ **粗體內容** ## 斜體選擇內容后按編輯器工具欄上的![](https://box.kancloud.cn/2701336414b5a8c949935b9a8cc32cb7_33x31.png)或者使用`CTRL+I`快捷鍵。示例效果： ~~~ _斜體內容_ ~~~ *斜體內容* ## 刪除線選中內容后按編輯器工具欄上的![](https://box.kancloud.cn/8fa74c215bf1b0fc54964b1327133c45_31x30.png)按鈕或者使用`CTRL+SHIFT+X`快捷鍵。示例效果： ~~~ ~~刪除內容~~ ~~~ ~刪除內容~ ## 無序列表選擇多行內容后按編輯器工具欄上的![](https://box.kancloud.cn/dfebeb21f5e5f8cc5279f2b1fc793b9d_34x34.png)或者使用`CTRL+ALT+U`快捷鍵。示例效果： ~~~ * 列表項1 * 列表項2 * 列表項3 * 列表項4 ~~~ * 列表項1 * 列表項2 * 列表項3 * 列表項4 支持使用多級列表： ~~~ * 列表項1 * 列表項2 * 子列表項1 * 子列表項2 ~~~ * 列表項1 * 列表項2 * 子列表項1 * 子列表項2 ## 有序列表選擇多行內容后按編輯器工具欄上的![](https://box.kancloud.cn/ee415ccbd96990728e1552a7a78cc789_32x30.png)或者使用`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 ## 任務列表可以定義任務列表，直接點擊編輯器工具欄的![](http://help.kancloud.cn/images/screenshot_1549605497235.png)或者使用`CTRL+ALT+T`快捷鍵，并且一樣支持多級，格式如下： ~~~ * [ ] 代辦事項1 * [ ] 代辦事項2 * [x] 完成事項3 * [x] 完成事項4 ~~~ * 代辦事項1 * 代辦事項2 * 完成事項3 * 完成事項4 ## 鏈接選擇要添加鏈接的內容后按編輯器工具欄上的![](https://box.kancloud.cn/1ab256f9a9de51eb058521e9d65985b5_33x31.png)或者使用`CTRL+L`快捷鍵。示例效果： ~~~ [鏈接文字](http://www.hmoore.net) ~~~ [鏈接文字](http://www.hmoore.net/) >[info] 還有一種簡單的方式可以直接輸入一個規范的鏈接地址，會自動識別為鏈接，而無需使用markdown鏈接規范。 ~~~ 看云的網址是：http://www.hmoore.net ~~~ 看云的網址是：[http://www.hmoore.net](http://www.hmoore.net/) >[info] 網址前后加上空格可以避免混淆上述寫法中鏈接地址中不能含有括號，如果你的鏈接地址中帶有括號的話，可以使用下面的方式： >[info] ~~~ > [鏈接文字] [1] > 這里可以添加任何內容 > 然后在頁面的任意位置添加如下： > [1]: http://www.hmoore.net/test_address > > ~~~ 如果要添加內鏈地址，可以直接把鏈接地址寫成版本庫的文件地址，例如： ~~~ [寫作規范](寫作規范.md) ~~~ [寫作規范](http://help.kancloud.cn/66780) 支持直接拖動左邊的目錄當當前頁面的光標位置直接插入。 ## 腳注可以給內容添加腳注功能，例如： ~~~ 看云是一個文檔寫作[^write]和托管平臺[^platform]。 // 中間可以添加其他內容 [^write]: 寫作格式采用Markdown格式，支持版本和多人寫作。 [^platform]: 發布的文檔可以直接在平臺閱讀、分享和私有存儲，并支持付費閱讀。 ~~~ > 通常可以把腳注的內容解釋統一放到頁面最后。腳注的鏈接效果如下：看云是一個文檔寫作和托管平臺。 ## 圖片有二種方式可以添加圖片： 1. 點擊編輯器工具欄上的![](https://box.kancloud.cn/ac689ca486af8eb6d32f08ce6fd048a6_34x30.png)或者使用`CTRL+ALT+Y`快捷鍵彈出文件上傳選擇框后點擊上傳需要的圖片文件即可。 2. 復制網頁上的圖片或者直接截屏操作后在編輯器中進行粘貼操作，圖片也會自動上傳到當前光標位置顯示，如果你選擇了某段文字后粘貼的話，該段內容會作為圖片的ALT信息顯示。所以，在創作文檔的時候，你可以根據你的需要采用不同的方式上傳圖片。 > 關于設置圖片大小：默認圖片是自適應顯示的，如果需要設置圖片文件的大小可以使用 ~~~ ![](https://box.kancloud.cn/36b63669cdf9a2879646b217dba405ef_100x100.png) ![](https://box.kancloud.cn/36b63669cdf9a2879646b217dba405ef_100x100.png =50x50) ~~~ 示例： ![](https://box.kancloud.cn/36b63669cdf9a2879646b217dba405ef_100x100.png) ![](https://box.kancloud.cn/36b63669cdf9a2879646b217dba405ef_100x100.png) >[danger] 如果上傳了非圖片文件，將無法顯示 ## 外部圖床支持使用外部云存儲來保存圖片，這樣不會占用看云本身的文檔空間，但需要注意會影響打包的性能（如果外部圖片較多的情況下可能會打包失敗），但在線閱讀不受任何影響。打開文檔設置->插件管理后，添加云圖片插件 ![](https://box.kancloud.cn/095e44c3a11852268177e30856af1793_263x106.png) 刷新頁面后再次打開文檔設置頁面，在插件設置找到云圖片 ![](http://help.kancloud.cn/images/screenshot_1549605704620.png) 在插件設置頁面選擇七牛或者又拍云，然后設置相關的key（參考七牛或者又拍云的文檔），點擊應用后就可以把圖片直接傳到指定的云存儲了。 >[info] 注意：如果安裝了云圖片插件后必須及時設置好存儲參數，否則會導致所有圖片都不能上傳。 ## 行內代碼選擇代碼段落后后按編輯器工具欄上的![](https://box.kancloud.cn/7093186f78fb076ae9024407d5618cc8_32x30.png)或者使用`CTRL+E`快捷鍵。示例效果： ~~~ 行內代碼 `define('APP_DEBUG', false);` ~~~ 行內代碼`define('APP_DEBUG', false);` ## 代碼段選擇工具欄的![](http://help.kancloud.cn/images/screenshot_1549605921501.png)按鈕或者使用`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); // 是否調試模式 ``` ~~~ ## 分割線點擊編輯器工具欄上的![](https://box.kancloud.cn/fee729232479f4882666ca8274ae287c_28x30.png)或者使用`CTRL+H`用于插入一條分割線。示例效果： ~~~ * * * * * ~~~ * * * ## 引用選擇內容后按編輯器工具欄上的![](https://box.kancloud.cn/177faab4805e02ff98ed3b5dd225a50b_33x30.png)或者使用`CTRL+Q`快捷鍵。示例效果： ~~~ > 這是一段引用內容文字 > 這是第二行引用內容文字 > 這是第三行引用內容文字 ~~~ >[info] 這是一段引用內容文字這是第二行引用內容文字這是第三行引用內容文字在引用內容中還可以使用部分其他的格式，例如： ~~~ > 這是一段引用內容文字 **粗體內容** > 這是第二行引用內容文字 _斜體內容_ > 這是第三行引用內容文字 `單行代碼` > [這是一個鏈接](http://www.hmoore.net) ~~~ >[info] 這是一段引用內容文字**粗體內容**這是第二行引用內容文字*斜體內容*這是第三行引用內容文字`單行代碼`[這是一個鏈接](http://www.hmoore.net/) 支持多級引用，例如： ~~~ > 引用內容 > > > 子引用內容 > > 子引用內容 ~~~ >[info] 引用內容 > > >[info] 子引用內容 > > 子引用內容 **引用樣式支持** 可以通過引用樣式對引用內容進行特別的強調，目前支持四種引用樣式，分別是： info： ~~~ >[info] 這里是**提示信息** >通常用于一些提醒事項 ~~~ >[info] 這里是**提示信息** > 通常用于一些提醒事項 warning： ~~~ >[warning] 這里是**警告信息** >通常用于一些警告事項 ~~~ >[warning] 這里是**警告信息** > 通常用于一些警告事項 success： ~~~ >[success] 這里是**成功信息** >通常用于一些成功提示 ~~~ >[success] 這里是**成功信息** > 通常用于一些成功提示 danger： ~~~ >[danger] 這里是**危險信息** >需要引起特別的注意 ~~~ >[danger] 這里是**危險信息** > 需要引起特別的注意 ## 段落排版支持段落的居左、居中和居右排版，選中段落內容后點擊工具欄上面的![](https://box.kancloud.cn/757f88555ae3ced7c0ca5d97ee0df8dc)按鈕就可以對段落進行居左（`CTRL+ALT+L`）、居中（`CTRL+ALT+E`）和居右（`CTRL+ALT+R`）排版了。并且也支持圖片和引用段落的排版。示例： ~~~ 這是一個居左的段落 :-: 這是一個居中的段落 --: 這是一個居右的段落 >[info] --: 這里是居右的引用內容 :-: ![](https://box.kancloud.cn/cover_2015-07-17_55a8b9187bde_800x1068.jpg-bookmiddle) :-: 圖片居中 ~~~ 這是一個居左的段落 :-: 這是一個居中的段落 --: 這是一個居右的段落 >[info] --: 這里是居右的引用內容 :-: ![](https://box.kancloud.cn/cover_2015-07-17_55a8b9187bde_800x1068.jpg-bookmiddle) :-: 圖片居中 ## 表格點擊工具欄上的![](https://box.kancloud.cn/1717f2da7b6c7acb3841c0c261324767_35x33.png)按鈕插入表格的單元項。示例效果： ~~~ | 編號 | 產品 | 描述 | |---|---|---| | 1 | ThinkPHP | 開源WEB應用框架 | | 2 | OneThink | 開源內容管理框架 | | 3 | 看云 | 文檔托管平臺 | ~~~ | 編號 | 產品 | 描述 | | --- | --- | --- | | 1 | ThinkPHP | 開源WEB應用框架 | | 2 | OneThink | 開源內容管理框架 | | 3 | 看云 | 文檔托管平臺 | 支持對單元列設置對齊方式，例如： ~~~ | 編號（居右對齊） | 產品（居中對齊） | 描述（居左對齊） | | ---: | :---: | :--- | | 1 | ThinkPHP | 開源WEB應用框架 | | 2 | OneThink | 開源內容管理框架 | | 3 | 看云 | 文檔托管平臺 | ~~~ | 編號（居右對齊） | 產品（居中對齊） | 描述（居左對齊） | | ---: | :--: | ---: | | 1 | ThinkPHP | 開源WEB應用框架 | | 2 | OneThink | 開源內容管理框架 | | 3 | 看云 | 文檔托管平臺 | >[info] 注：markdown規范不支持復雜的表格，如果需要，可以自行粘貼表格的HTML代碼，可以直接顯示。 ## 數學公式看云支持在內容中插入數學公式，但需要設置使用`tex`插件，在編輯模式下面打開右上角的插件管理，添加數學公式插件： ![](https://box.kancloud.cn/218a2399e6a6404bbfb0a9a0f71d3b50_148x220.png) 然后在插件設置里面找到數學公式后安裝 ![](https://box.kancloud.cn/109c80f76ba34426a91f91b465e0498f_273x113.png) 然后，你就可以直接在編輯區輸入公式定義，例如：單行公式： ~~~ `$ c = \pm\sqrt{a^2 + b^2} $` ~~~ 支持多行的寫法多行的公式會居中顯示如： ~~~ ```[tex] f(x) = \int_{-\infty}^\infty \hat f(\xi)\,e^{2 \pi i \xi x} \,d\xi ``` ~~~ 實際效果如圖： ![](http://box.kancloud.cn/document_2015-10-05_56126f27bd91b.png) ## 流程圖和時序圖支持在文檔中直接插入和編輯流程圖及時序圖，只需要使用`flow`和`sequence`插件，打開文檔設置->插件管理安裝相應的插件，添加： ![](https://box.kancloud.cn/fba34d636ae749f610867563813c1ff3_1011x586.png) 然后在文檔中使用下面的方式添加流程圖和時序圖即可。流程圖： ~~~ ```[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 ``` ~~~ 效果如圖所示： ![](https://box.kancloud.cn/2e3a1053e0a65bea086342cbea141114_351x478.png) 時序圖： ~~~ ```[sequence] Title: Here is a title A->B: Normal line B-->C: Dashed line C->>D: Open arrow D-->>A: Dashed open arrow ``` ~~~ 實際效果如圖： ![](https://box.kancloud.cn/e32566701b979c8e392d086ad57663e2_379x302.png) ## 視頻可以支持插入視頻內容（目前僅支持插入優酷視頻），需要使用`youku`插件，添加優酷視頻插件： ![](https://box.kancloud.cn/3e73c3b65ac374220d8037bc6e0ef300_270x106.png) 刷新頁面后可以在工具欄看到![](https://box.kancloud.cn/bfc09afb3442c835da07bd3a03ee4abf_34x31.png)按鈕，點擊彈出 ![](https://box.kancloud.cn/11282891f3dbc21eec3eb97559b4249c_720x415.png) 把你的優酷視頻地址或者ID直接粘貼過來就可以了，如果設置了視頻密碼的話，還可以設置免密碼播放（需要用戶開通視頻私密托管服務）。 ## 轉義符如果你需要輸入一些特殊的符合，但又不希望被用于Markdown標簽解析，那么可以使用轉義符，Markdown支持以下這些符號前面加上反斜杠來幫助插入普通的符號： ~~~ \ 反斜線 ` 反引號 * 星號 _ 底線 {} 花括號 [] 方括號 () 括弧 # 井字號 + 加號 - 減號 . 英文句點 ! 驚嘆號 ~~~ 例如： ~~~ \*看云文檔托管平臺\* \_看云文檔托管平臺\_ \#\# 看云文檔托管平臺 ~~~ \*看云文檔托管平臺\* \_看云文檔托管平臺\_ \## 看云文檔托管平臺 ## 章節導航可以在當前內容中插入（當前內容頁的）章節導航，點擊編輯器工具欄上的![](https://box.kancloud.cn/8296d7955a09fdb68b9aebd890e4eede_32x30.png)按鈕會在光標位置插入`[TOC]`，在右側預覽區就可以看到會自動提取當前內容的目錄結構。 >[info] 注意：`[TOC]`后面必須增加一個空行才能正確顯示目錄結構。默認情況下`[TOC]`在頁面解析的時候會自動提取當前頁面中的所有`H1~H6`的內容作為目錄展示（包含層次關系），如圖所示： ![](http://box.kancloud.cn/document_2015-09-08_55eeba371284a.png) 如果你希望定制目錄的層級顯示，例如只希望提取部分內容作為目錄顯示，可以使用： ~~~ [TOC=2] // 提取H1到H2的內容顯示 [TOC=3] // 提取H1到H3的內容顯示 [TOC=2,3] // 提取H2到H3的內容顯示 ~~~ ## 撤銷和重做在編輯內容的過程中可以使用`CTRL+Z`和`CTRL+Y`快捷鍵或者點擊編輯器工具欄上的![](https://box.kancloud.cn/5960c138a30e056754c2faf8d2b8687d_69x35.png)進行撤銷和重做操作。 ## 全文預覽文檔在沒有發布之前，其它用戶是無法閱讀的，但作者或者文檔成員中具有編輯以上權限的用戶（包括創始人、管理員和編輯）可以進行預覽操作。點擊右上角的全文預覽按鈕![](https://box.kancloud.cn/8817dfd3aab73ffe4f78e1e089a7e614_41x33.png)可以進行和最終閱讀效果一致的全文預覽。 ## 編輯器設置在編輯器界面的右下角有一個設置按鈕![](https://box.kancloud.cn/b1c8d556e1e2237ef9515162efa14e52_62x48.png)，點擊該按鈕可以設置是否顯示預覽和目錄欄。如果你的分辨率比較低，可以設置關閉自動預覽顯示，然后在寫完后使用右上角的全文預覽。 ![](https://box.kancloud.cn/1383791723c1ef751a36cfa927eac496_160x280.png) 可以點擊![](https://box.kancloud.cn/a5aca0a577f13035b7b3eea3cf79b54f_136x40.png)在MD編輯器和可視化編輯器之間切換。后面我們會單獨介紹可視化編輯模式。 ## 同步內容編輯過程中不需要進行保存操作，系統會自動保存到該文檔的暫存區，只有在點擊同步操作的時候才會實際提交到版本庫，如果需要同步內容，可以隨時點擊編輯器工具欄上的![](https://box.kancloud.cn/6b3d046f47bf55d2f73b730265493468_40x38.png)。默認情況下該按鈕呈灰色狀態![](https://box.kancloud.cn/2fa709c0f24f3bad5349aa484640db96_37x34.png)，當有內容更新后，會自動顯示為![](https://box.kancloud.cn/6b3d046f47bf55d2f73b730265493468_40x38.png)說明這個時候可以進行同步操作。寫作格式采用Markdown格式，支持版本和多人寫作。發布的文檔可以直接在平臺閱讀、分享和私有存儲，并支持付費閱讀。