云端概述
约 1768 字大约 6 分钟
2026-06-10
奕澄Markdown的云端功能用于连接你自己配置的 WebDAV 或 S3 兼容对象存储服务，并在统一的云端浏览器中管理文件。云端 Markdown 会下载到本地镜像目录后编辑，再按设置回传云端；文档引用的本地图片也可以按相对路径下载或上传。
云端功能依赖第三方服务的协议兼容性、账户权限、网络和存储配额，不等同于奕澄Markdown提供的网盘。首次接入时，建议先用测试目录验证上传、下载和删除，再存放重要文档。
可以做什么
- 分别管理多个 WebDAV、S3 账户，并按需启用或停用。
- 浏览云端目录，新建 Markdown 和文件夹。
- 将本机文件或图片导入当前云端目录。
- 下载、编辑或预览云端文件，以及复制、移动、重命名和删除文件。
- 编辑云端 Markdown 后，将文档回传到原云端位置。
- 按文档中的相对路径下载缺失图片，或将本地图片上传到对应的云端镜像位置。
首次使用
1. 添加并启用账户
进入 设置 > 云端设置 > 账户管理，在顶部选择 webdav 或 S3，再点击右上角的新建按钮添加账户。保存后，确认账户的 是否启用 已打开。
协议选择会同时影响账户管理页和云端浏览器当前显示的账户类型。两个协议可以分别保存多个账户，但云端浏览器一次使用一个当前账户。
2. 确认本地镜像缓存根目录
进入 设置 > 云端设置 > 本地镜像缓存根目录。默认值为：
/YiCheng/应用会在这个目录后自动拼接当前账户昵称。例如，账户昵称为“坚果云”时，其镜像根目录为：
/YiCheng/坚果云/云端文件下载后会保留相应的路径层级。账户昵称不仅用于显示，也参与本地目录映射，建议使用简短、互不重复且不包含路径分隔符的名称。镜像根目录和账户昵称也建议在使用初期确定，之后谨慎修改。
3. 打开云端浏览器
从应用侧边栏进入 云端，选择协议和已启用的账户。页面会显示云端根路径与本地镜像路径的对应关系；点击本地镜像路径，可进入资源管理查看已经缓存到本机的文件。
如果提示尚未配置云端账户，请返回 云端设置 > 账户管理 检查是否已添加并启用当前协议的账户。
4. 新建、导入或打开文件
- 使用底部 新建 创建 Markdown 或文件夹。
- 使用底部 导入 将本机文件、图库图片等导入当前云端目录。
- 点击云端 Markdown 后，应用会先下载到本地镜像目录，再进入编辑器。
- 使用顶部刷新按钮重新获取当前目录；文件变更未显示时可先刷新。
在文件或文件夹上长按，或在电脑端点击鼠标右键，可打开对应的操作菜单。删除、移动和重命名会直接操作云端数据，执行前请确认目标。
三项同步设置
在 设置 > 云端设置 中可以分别配置以下项目，默认值均为 自动。它们控制不同内容，不能相互替代。
| 设置 | 自动 | 手动 |
|---|---|---|
| 云端文档同步 | 云端镜像 Markdown 在本地保存后，回传到对应云端位置 | 在编辑器云端菜单选择 上传文档到云端 |
| 云端资源下载 | 打开云端 Markdown 时，下载文中引用且本地缺失的相对路径图片 | 在编辑器云端菜单选择 资源下载到本地 |
| 云端资源上传 | 编辑云端 Markdown 并插入图片时，将图片上传到云端镜像对应位置，并插入相对路径 | 使用 资源上传到云端，或图片菜单中的上传到云端选项 |
单文档编辑器的顶部菜单和多页签编辑器的更多菜单提供相应云端操作。图片上的长按或鼠标右键菜单还提供 上传此图片到云端、上传全部本地图片到云端 等操作。
本地保存与云端同步不是一回事
编辑器的手动保存、周期自动保存决定内容何时写入本地文件；云端文档同步决定已保存的云端镜像文档何时回传。自动云端同步不是每次输入都实时上传。
手动执行 上传文档到云端 时，应用会先保存当前文档，再上传该文档，不受云端文档同步的自动/手动模式限制。
图片使用相对路径
对于云端文档，推荐使用应用默认的相对路径图片组织方式，例如：
资源下载会依据当前 Markdown 的云端位置解析 ./、../ 等相对路径，并将图片放入对应的本地镜像位置。以下情况需要特别注意：
- 自动下载主要补齐本地缺失的图片，不会因为云端图片更新就自动替换已有缓存。
http(s)网络图片仍按网络图片处理，不属于相对路径资源预取范围。- 编辑过程中新增的引用，可手动执行一次 资源下载到本地。
- 自动上传失败时，本地图片和相对路径引用会保留；恢复网络或修正权限后，可再手动上传。
使用边界与安全建议
- 不是所有本地文件的全量双向同步。 普通本地文档不会因为添加了云端账户就自动上传；云端目录也不会在后台全部下载到本机。
- 不要同时在多台设备编辑同一文档。 当前流程不提供多人协作式的内容合并，后上传的版本可能覆盖先前版本。
- 重新下载前先处理未上传修改。 如果本地缓存和云端文件都有改动，请先备份或上传需要保留的版本，避免重新下载覆盖本地缓存。
- 删除云端文件前确认。 在云端浏览器中删除、移动或重命名会直接改变第三方服务中的数据；重要内容请另行备份。
- 保护账户凭据。 不要在截图或文档中公开 WebDAV 密码、S3 Access Key 或 Secret Key，建议为应用创建权限受限的专用账户或密钥。