奕澄Markdown

简体中文

English

简体中文

English

外观

使用须知

约 5896 字大约 20 分钟

2026-04-19

云端与图床的完整配置步骤和排查方法见以下固定链接：

1、云端注意事项（S3）

奕澄Markdown提供统一的对象存储（S3 兼容协议）服务的配置界面，下面我按从上到下的顺序，给你逐一拆解每个配置项的含义和使用。

目前通过测试：

  • Minio

  • 七牛云

  • 阿里云

  • 腾讯云

目前体验最好的是Minio，其他可能存在兼容性问题导致部分功能不可用。

  1. 账户昵称

    昵称在本地缓存会自动生成对应的目录，必须填写

    含义：给这个存储配置起一个别名/备注，方便你自己识别这是哪个账号、哪个服务。 示例：可以填 阿里云OSS、腾讯云COS、MinIO本地存储、七牛云等，完全是自定义的备注，不影响实际连接，只是为了方便区分多个存储配置。

  2. Endpoint 含义：也叫「访问域名/节点地址」，是对象存储服务的服务器地址，是客户端和存储服务建立连接的入口，必填。 作用：客户端通过这个地址知道要访问哪个服务商、哪个区域的存储服务。 示例： 阿里云OSS（华东1）：https://oss-cn-hangzhou.aliyuncs.com 腾讯云COS（广州）：https://cos.ap-guangzhou.myqcloud.com 本地MinIO：http://192.168.1.100:9000 注意：需要写完整的 http:// 或 https:// 地址。

  3. Access Key 含义：也叫「AK / AccessKey ID」，是对象存储服务的公钥身份标识，相当于你的账号的“用户名”，必填。 作用：和下面的 Secret Key 配对使用，用来验证你的客户端是否有权限访问存储服务。 获取方式：在你的云服务商控制台（阿里云、腾讯云、AWS、MinIO 等）的「访问密钥/API密钥」页面生成，注意： 不要泄露给他人，否则可能被滥用 部分服务商支持创建子账号密钥，限制权限更安全

  4. Secret Key 含义：也叫「SK / AccessKey Secret」，是对象存储服务的私钥身份凭证，相当于你的账号的“密码”，必填。 作用：和 Access Key 配对使用，用来对请求进行签名，证明你是合法用户。 注意： 这是最高敏感信息，一旦泄露，别人可以用它操作你的所有存储数据，必须妥善保管，不要在公网传输、截图泄露 部分服务商支持临时密钥，有效期更短，安全性更高

  5. Bucket 含义：也叫「存储桶」，是对象存储中用来存放文件的顶级容器，相当于一个独立的“文件夹/磁盘分区”。 作用：对象存储中，所有的文件（Object）都必须存放在某个 Bucket 里，客户端通过这个配置知道要读写哪个存储桶。 示例：你在阿里云OSS创建的 my-backup-bucket 名称，需要和服务商控制台中创建的Bucket名称完全一致。 补充：一个账号可以创建多个Bucket，用来分类存放不同用途的文件（比如备份、静态网站、日志）。

  6. Region ID 含义：也叫「区域/地域ID」，是对象存储服务的服务器所在物理区域的标识，必填。 作用：部分S3兼容服务（比如AWS S3、阿里云OSS）会根据Region ID 做请求路由，确认你要访问哪个区域的服务，避免跨区域访问出错。 示例： 阿里云OSS华东1：oss-cn-hangzhou 腾讯云COS广州：ap-guangzhou AWS S3北京：cn-north-1 补充：部分自建S3服务（如MinIO）可以填任意值，不影响使用。

  7. 根路径（默认为 /）

    尽量不要填/，而是指定Bucket下的子目录

    含义：这是「远程存储路径/前缀」，用来指定文件要存放在Bucket下的哪个子目录里。 示例： 填 /backup/photos/：文件会上传到 Bucket/backup/photos/ 目录下 填 /（默认值）：文件会直接存放在Bucket的根目录下 作用：可以用这个配置实现“多客户端共享同一个Bucket，但数据互不干扰”，比如A客户端填 /userA/，B客户端填 /userB/，数据就会分开存放。

  8. 是否启用 含义：这是一个总开关，用来控制这个存储配置是否生效。 状态说明： 关闭状态（灰色）：这个配置不会被使用 开启状态（一般为亮色）：云端会加载这个配置 用途：方便你临时停用某个配置，而不用删除或清空上面的所有信息。

  9. Path-style

    目前暂时只支持Path-style，后续将会支持Virtual-hosted-style

    含义：也叫「路径访问模式」，是S3协议的两种访问方式之一，用来控制客户端请求Bucket时的URL格式。

    两种模式对比：

    模式URL示例说明Path-stylehttps://endpoint/bucket-name/object把Bucket名称放在Endpoint的路径里

    Virtual-hosted-stylehttps://bucket-name.endpoint/object把Bucket名称放在域名里

    适用场景：

    自建MinIO、部分兼容服务，通常需要开启Path-style模式

    主流云服务商（阿里云、腾讯云、AWS），一般用默认的Virtual-hosted-style即可

  10. Skip

    目前此配置无作用，后续可能会启用此配置

    含义：全称一般是「Skip TLS Verify / Skip SSL Check」，即「跳过SSL证书验证」。 作用：当你的Endpoint是自建HTTPS服务、使用自签名证书时，客户端默认会验证证书合法性，开启Skip后，会跳过证书验证，允许连接不安全的HTTPS服务。 风险提示： 仅建议在本地局域网、完全可信的自建服务中使用 公网环境开启会有中间人攻击风险，不建议使用

2、云端功能注意事项（Webdav）

以坚果云为例：

https://dav.jianguoyun.com/dav

  • 用户昵称

    云端账户的昵称，设置后会自动创建与用户昵称相同的文件夹作为此账号的本地缓存根目录，比如：坚果云

  • 域名/IPv4

    webdav账户的域名地址或IPv4地址，比如：dav.jianguoyun.com或192.169.1.32

  • 端口

    webdav账户的端口号，如果协议为http一般为80，如果协议为https一般为443（这里受下方强制HTTPS项影响），如果是其他端口则在自定义填写

  • 用户账号

    webdav账户的账号名称，比如xxx@qq.com

  • 用户密码

    webdav账户的账号密码

  • 根目录

    域名/IPv4后的根目录地址，根据实际情况填写，比如：/dav/

  • 强制HTTPS

    强制开启HTTPS安全套接字加密，注意看云端账户地址的协议类型是http还是https

  • 是否启用

    账户是否启用，启用后才可以在云端中使用此账户

最终完整url示例：

如果开启HTTPS：https://dav.jianguoyun.com:443/dav/

如果未开启HTTPS：http://dav.jianguoyun.com:80/dav/

其他示例：

http://192.168.1.32:8080/dav/

https://192.168.1.34:9090/dav/

3、图床设置注意事项

图床（Image Host）是奕澄Markdown 2.0.2 起上线的 Pro 会员功能，可将编辑器内插入的本地图片上传到指定服务器或云端账户，并在文档中引用返回的图片链接，有效减小文档体积、方便多端共享。下面按「设置 > 图床设置 > 新增/编辑图床」界面顺序逐一说明。

当前「图床设置」和「个性化设置 > 编辑器 > 编辑器应用图床」均为永久 Pro 功能入口，具体权益以应用内页面为准。

图床类型

图床支持两类「图床类型」：

  • 服务器地址：通过 HTTP 协议把图片上传到你（或第三方）指定的图床服务器，上传成功后返回该图片的访问地址。

  • 云端地址：绑定「云端设置」中已配置的 WebDAV 或 S3 账户，把图片上传到该账户，并生成免认证直链地址。

（1）图床名称

含义：给这个图床起一个别名/备注，方便你自己识别（如「七牛云」「阿里云图床」「123云盘图床」），必填，完全自定义，不影响实际连接。

（2）空间地址（仅「服务器地址」类型显示）

含义：图床服务器的上传接口地址，必填，需要填写完整的 http:// 或 https:// 地址。当前接口约定如下：

  • 请求使用 HTTP POST 和 multipart/form-data，图片文件字段名为 file，上传时保留原始文件名；连接和读取超时时间均为 30 秒。

  • 上传成功要求接口返回 HTTP 2xx 状态码，JSON 响应体顶层包含非空的 url 字段，且其值为以 http 开头的图片绝对地址。

  • 当前没有自定义请求头、鉴权 Header 或额外表单字段入口。需要额外鉴权参数或返回其他响应结构的接口，需先由服务端适配上述约定。

（3）上传账户（仅「云端地址」类型显示）

含义：选择要把图片上传到哪个「云端账户」，账户来自「设置 > 云端设置 > 账户管理」。

  • 若还没有云端账户，可点击页面中的创建引导前往账户管理新建。

  • 图床固定使用这里绑定的账户，不会自动跟随云端浏览器或文档同步的当前账户。

  • 云端账户的「是否启用」只控制云端浏览和同步，不会阻止已绑定账户用于图床上传。

（4）图床根目录（仅「云端地址」类型显示）

含义：图片在云端账户中的存储子目录，默认为 YICHENG_IMAGEHOST，支持多级目录（如 img/blog，用 / 分隔）。

  • WebDAV：上传至「账户根目录/图床根目录/」，直链为「直链域名/图床根目录/文件名」。

  • S3：对象键为「账户根目录/图床根目录/文件名」。

  • 修改根目录只影响之后上传的图片，已插入文档的旧链接不会改变。

  • 同名文件可能覆盖远端已有对象，重要图片请避免重名，或按用途分目录保存。

（5）直链域名与「测试直链」

含义：「直链域名」是无需登录即可直接访问图片的域名或 CDN 域名，用于生成最终图片地址。能上传并不代表能作为图床，还必须满足公开访问条件：

  • WebDAV：必须配置可用的免认证直链域名，可点击「测试直链」检查；普通 WebDAV /dav/ 等鉴权接口不能直接作为公开图片地址。

  • S3：Bucket 或对象需要允许公开读取，或者配置可公开访问的 CDN/自定义域名。应用不会自动修改 Bucket 权限，也不会把临时预签名 URL 作为长期图床链接。

  • 坚果云当前不支持作为云端图床。直链测试失败不会阻止保存配置，但未解决问题前，插图会回退为本地保存。

（6）是否启用

含义：图床的总开关。可以保存多个图床配置，但全局同时只能启用一个默认图床。

  • 开启新图床时若已有启用中的图床，应用会询问是否切换默认图床。

  • 新建、编辑、删除或切换图床不会改写文档中已有的图片链接，只影响之后的上传操作。

编辑器应用图床开关

（1）「个性化设置 > 编辑器 > 编辑器应用图床」默认开启。只有开关已打开且存在可用的默认图床时，编辑器插入本地图片才会上传图床；关闭后按图片插入模式保留本地相对路径。

（2）编辑云端镜像文档且「云端资源上传」设为自动时，图片优先按云端相对路径上传到对应镜像位置；图片菜单中显式选择「上传到图床」仍走独立的图床通道。

上传失败与手动重传

  • 图床上传失败时会保留本地图片，并回退为本地相对路径，不会因上传失败直接丢失插图。

  • 对已经插入的本地图片，可在编辑器中长按图片或电脑端右键图片，选择「上传此图片到图床」或「上传全部本地图片到图床」。手动重传前需确认编辑器应用图床开关和默认图床可用。

  • 已经是 http(s) 地址的网络图片不会因为设置了默认图床而自动转传。

图床上传支持的图片格式

图床与「编辑器上传」所支持的格式一致：.png、.jpg、.jpeg、.gif、.svg（详见「编辑器上传注意事项」）。

4、笔记空间注意事项

（1）手机端仅支持应用内部的文件夹作为笔记空间，2in1、PC、平板支持内部、文档、下载、华为云盘或选择其他文件夹作为笔记空间；

（2）系统版本推荐使用HarmonyOS6.0及以上，API版本20及以上，如果不是建议升级；

（3）如果某个文件夹作为笔记空间失败，大概率是授权问题，请检查该文件夹权限；

5、图片插入模式注意事项

（1）奕澄Markdown自版本1.1.0开始默认使用./assets作为资源图片保存路径；

（2）如果使用Typora、Obsidian、MarkText进行文档流转，强烈建议保证资源图片保存路径与奕澄Markdown一致；

6、应用接续注意事项

（1）应用接续请尽量保证应用的版本号一致；

（2）应用接续默认是关闭状态，只有在进入md的编辑器页面才可以触发接续。

（3）支持接续时md中依赖的图片资源也被接续，但注意尽量也来的图片资源大小不应太大或过多，可能会导致接续失败，如果接续失败可多此重试。

7、手写画板注意事项

（1）暂存一下功能只是“暂存”，应用重启后会被清理，如果需要永久保存，请使用截取保存功能，后续看使用情况进行优化。

8、防窥保护注意事项

  • 奕澄个性化设置的防窥保护设置开启之前，需请检查系统设置：[设置-隐私和安全-防窥保护-打开防窥保护开关和下方奕澄Markdown应用的开关]是否正确设置，否则无效果。
  • 仅支持手机和平板且系统为HarmonyOS6.0.0(API20)。

9、碰一碰注意事项

  • 仅支持手机与手机、手机与PC/2in1设备碰一碰。

  • 碰一碰分享文件有数量限制，如果是编辑文档分享，建议使用接续功能。

  • 碰一碰可参考以下场景步骤：

    • 【场景1->碰一碰手机图片直插文档到PC】

      步骤1：电脑端新建文档test.md（文件名任意）

      步骤2：手机端打开图库，选择图片

      步骤3：PC端打开test.md文档的编辑器页面

      步骤4：手机轻触PC屏幕，触发碰一碰

    • 【场景2->碰一碰手机文档分享到PC直接打开编辑】

      步骤1：手机端新建文档test.md（文件名任意）

      步骤2：任意写一些文字内容

      步骤3：电脑端任意打开一个文档进入多页签编辑页面

      步骤4：手机轻触PC屏幕，触发碰一碰

      【场景3->碰一碰手机文档分享直达多部手机设备编辑】

      步骤1：手机端新建文档test.md（文件名任意）

      步骤2：任意写一些文字内容

      步骤3：碰一碰多部手机，上滑一起分享过去

      【场景4->碰一碰手机文件直达资源管理】

      步骤1：电脑端打开资源管理页面

      步骤2：手机端打开文件管理，选择图片、md、.pdf、.zip等类型文件

      步骤3：手机轻触PC屏幕，触发碰一碰

    • 【场景5->碰一碰PC文档分享到手机】

      步骤1：电脑端新建文档test.md（文件名任意）

      步骤2：任意写一些文字内容

      步骤3：手机端退出应用（保证后台没有运行奕澄Markdown），回到桌面

      步骤4：手机轻触PC屏幕，触发碰一碰

  • 如果打开不是应用内部的文档，由于系统权限限制，可能会导致碰一碰失败，如果使用碰一碰功能建议使用内部空间。

10、一抓一放隔空传送注意事项

使用隔空传送功能前，需要先打开隔空传送开关，开启路径：设置 > 系统 > 快捷启动和手势 > 隔空传送。

11、PDF生成注意事项

（1）如果markdown文档内容很多，文档很长则PDF生成需要时间很长，根据环形进度条提示，请耐心等待一会！

（2）如果导出的PDF内容显示不全，可尝试个性化设置-PDF导出宽度设置指定宽度再次尝试。

（3）奕澄Markdown在版本1.1.0起移除原有的截图导出PDF功能，为了更好的导出体验，请使用系统自带的打印-另存为pdf功能。

12、编辑器上传注意事项

目前只能上传图片，支持格式为：

  • .png
  • .jpg
  • .jpeg
  • .gif
  • .svg

13、导入注意事项

注意：Markdown文件目前支持识别.md后缀的文件！

（1）文件列表右上角-本地导入目前只支持导入.pdf或.md后缀的文件。

（2）文件列表支持直接拖拽导入.pdf或.md后缀的文件。

（2）资源管理-导入目前支持导入.pdf、.md、.zip以及2所述图片类型文件。

（3）资源管理支持直接拖拽导入.pdf、.md、.zip以及[2、编辑器上传注意事项]所述图片类型文件。

（4）其他导入方式：

  • a. 先将.md文档(如果后缀不是，先重命名)放在自带的文件管理中，长按-其他应用打开-选择奕澄Markdown，打开后会自动导入到奕澄，这时返回奕澄首页就会看到此markdown文档，如果没看到就下拉刷新一下；

  • b. 先将.md文档(如果后缀不是，先重命名)放在自带的文件管理中，长按-分享-选择奕澄Markdown，会有奕澄的分享面板，有导入按钮，点击导入奕澄即可；

  • c. 如果是不同设备同系统（鸿蒙Next）跨设备导入，可以使用分享-华为分享进行跨设备分享，文档打开后会自动导入奕澄；

  • d. 也可以使用超级终端协同时，将文件拖入到本机，然后重复以上a或b步骤即可；

  • e. 也可以使用超级终端协同时，将文件拖入到奕澄Markdown-资源管理中。

  • f. 也可以使用超级终端协同时，将文件拖入到奕澄Markdown-文件列表中（但暂且只支持.md或.pdf类型文件）。

（5）针对文件夹导入，平板/2in1/PC设备可以在首页（文件列表模式、文件夹模式）、资源管理等处使用文件夹导入菜单或直接拖拽文件夹的方式导入，手机端只支持拖拽文件夹导入。

14、导出注意事项

目前导出文档资源有以下方法：

  • markdown文件可[分享-另存为]可选择手机的用户目录保存。
  • pdf文件可[分享-另存为]可选择手机的用户目录保存。
  • 图片文件可[分享-另存为]可选择手机的用户目录保存。
  • 压缩包zip文件可[分享-另存为]可选择手机的用户目录保存。
  • 文件夹可[文件夹-长按-导出zip]后使用[分享-另存为]可选择手机的用户目录保存。
  • 文件夹可[文件夹-长按-分享zip]选择手机的用户目录保存。
  • 以上文件均支持统一拖拽。

15、分享注意事项

  • 如果想要将用户文件（比如在文件管理中的）.md或.pdf文件使用奕澄Markdown打开编辑，则使用系统文件管理的[分享]功能分享给奕澄Markdown或[其他应用打开]。

  • 目前不支持分享面板直接预览，可点击[导入奕澄]按钮将文件保存到应用里，在md或pdf列表中查看。

  • 如果文件不能分享，则可能是因为被分享端不支持此格式，请发送邮箱lotoze@qq.com反馈。

  • .md和.pdf类型文件支持华为分享直接预览。

  • 后续会逐渐适配其他常用的app~

16、卸载注意事项

目前没有自动同步云端的功能，如果卸载会导致文档全部丢失，请手动使用[分享功能-另存为]或[拖拽文件]将重要文件保存到用户文档中！！！

17、PDF打印注意事项

  • 使用分享-打印，会调起系统打印弹框，链接打印机打印。
  • PDF预览时右上角[打印]按钮可直接打印。

18、分享到微信注意事项

分享一次如果不成功请先启动微信再分享。

19、使用奕澄打开模式注意事项

  • 总是导入

    总是先导入当前笔记空间后再打开编辑，默认模式

    完整权限体验，不会出现授权现象，第一推荐～

  • 原位置授权

    由于鸿蒙系统本身安全权限限制，奕澄Markdown对于非本应用内部的文件读写权限受限，受影响功能场景如下：

    隔空传送（一抓一放）、跨设备华为分享、其他应用中打开MD文件使用奕澄Markdown打开（QQ&微信）

    以上功能场景鸿蒙系统会仅临时授权一次，后续在最近文件列表中会显示未授权的标识，需要手动查找选择一下此文件。

    注意：

    （1）奕澄对于某些特殊文件所在的位置无法直接定位到文件位置进行选择授权（文件地址包含“Users/currentUser/”授权时可以直接定位位置，不包含授权时则无法直接定位该文件位置）。

    （2）QQ和微信中使用奕澄Markdown打开则在[浏览-来源-QQ微信]中查找文件选择授权。

    给您带来的不便，奕澄非常抱歉～"

    适合偏重原位置编辑场景，部分场景需要手动授权，不推荐～

  • 总是询问

    总是弹框询问，自行选择是原位置授权编辑还是导入当前笔记空间编辑～

    强烈建议选择导入当前笔记空间编辑，可获得完整的文件读写权限原位置授权编辑因鸿蒙系统完全限制，对于部分功能场景无法获取读写权限，具体可查看【原位置授权】注意说明

    适合偏重自由选择的场景，第三推荐～

  • 自动

    应用根据文件所获的的权限自动选择是原位置直接编辑，还是导入当前笔记空间后编辑～

    兼容性比较强，不会出现授权现象，第二推荐～

匠心使然，热爱伟大！

愿奕澄与您同行~