>[danger]### 看云的编辑和阅读是完全分离的，所以看云文档写作的基本步骤是：编辑->同步->发布（如果开启自动发布的话第三步可以省略）。 ## 进入编辑模式 文档编辑一般有两个操作入口，在创建完成文档后，可以点击右上角的编辑按钮进行内容编辑，如图：  如果你当前位于我的文档列表页面的话，在我的文档列表中找到你需要编辑的文档，然后点击右侧的编辑按钮，点击就可以进行文档内容编辑工作了。  进入编辑模式后，可以看到默认打开的是一个包含一个目录的空白文档。  随便写一些内容，因为看云采用的是MarkDown格式的排版，左边是编辑区，右侧则是同步预览效果区，所以还是比较直观的。  ### 文档同步 完成当前内容编辑后会自动保存，但只有点击右上角的同步按钮  才会同步修改的内容到版本库（当前没有内容需要同步到服务器的时候按钮呈灰色），后面会详细描述下编辑器的用法。 > 编辑模式下的任何更改必须遵循编辑-》同步-》发布的三个步骤后，才能更新在线阅读版本。 ### 文档历史 点击同步按钮右侧的  按钮就可以查看当前内容的编辑历史记录，如图：  历史记录窗口左侧会显示当前内容的编辑历史记录，点击即可在右侧查看差异内容。 ### 全文预览 如果你需要和阅读环境一样预览当前文档的编辑内容，可以使用右上角的全文预览按钮  。 ### 系统帮助 右侧的帮助按钮可以快速进入看云的帮助手册。 ## 文档相关设置 文档编辑页面右上角有一个下拉菜单，这里可以进行一些文档相关的设置。  ### 文档概要 可以在文档概要里面添加文档的详细描述信息，会显示在阅读页面的概要中（一样使用`md`编码格式）。如图：  ### 封面设置 点击封面设置可以更换文档的封面图片，  上传更改封面图片后，必须要进行同步以及发布操作后才能生效，由于封面图片有CDN缓存，生效需要一定时间，如果更换后长时间没有生效，请清下你的浏览器缓存。 ### 样式设置 可以用于自定义当前文档的阅读样式，并且只能修改内容主体部分（`article-body`）的样式，例如，你可以设置你的阅读内容里面的`H2/H3`，`pre`，`code`等元素的样式。 ### 目录设置 在目录设置中你可以对目录文件进行高级编辑，但一定要注意目录文件的规范，只能包含列表内容（支持多级），而且不能包含空行。 ### 文档设置 文档设置主要用于设置文档使用的一些主题和插件配置，一般情况下无需设置。   ## 编辑区域设置 任何时候可以点击右下角的  按钮，进行编辑区域设置。 包括是否显示右侧的自动预览和左侧的目录栏，以及编辑模式的切换。  默认情况下，编辑器使用的是MD编辑器（带自动预览功能），你可以点击切换到可视化编辑模式。  如果你有任何问题和建议，也可以点击反馈建议随时反馈给我们。