使用须知

约 3876 字大约 13 分钟

2026-04-19

1、云端注意事项（S3）

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

目前通过测试：

Minio
七牛云
阿里云
腾讯云

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

账户昵称
昵称在本地缓存会自动生成对应的目录，必须填写
含义：给这个存储配置起一个别名/备注，方便你自己识别这是哪个账号、哪个服务。示例：可以填阿里云OSS、腾讯云COS、MinIO本地存储、七牛云等，完全是自定义的备注，不影响实际连接，只是为了方便区分多个存储配置。
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:// 地址。
Access Key 含义：也叫「AK / AccessKey ID」，是对象存储服务的公钥身份标识，相当于你的账号的“用户名”，必填。作用：和下面的 Secret Key 配对使用，用来验证你的客户端是否有权限访问存储服务。获取方式：在你的云服务商控制台（阿里云、腾讯云、AWS、MinIO 等）的「访问密钥/API密钥」页面生成，注意：不要泄露给他人，否则可能被滥用部分服务商支持创建子账号密钥，限制权限更安全
Secret Key 含义：也叫「SK / AccessKey Secret」，是对象存储服务的私钥身份凭证，相当于你的账号的“密码”，必填。作用：和 Access Key 配对使用，用来对请求进行签名，证明你是合法用户。注意：这是最高敏感信息，一旦泄露，别人可以用它操作你的所有存储数据，必须妥善保管，不要在公网传输、截图泄露部分服务商支持临时密钥，有效期更短，安全性更高
Bucket 含义：也叫「存储桶」，是对象存储中用来存放文件的顶级容器，相当于一个独立的“文件夹/磁盘分区”。作用：对象存储中，所有的文件（Object）都必须存放在某个 Bucket 里，客户端通过这个配置知道要读写哪个存储桶。示例：你在阿里云OSS创建的 my-backup-bucket 名称，需要和服务商控制台中创建的Bucket名称完全一致。补充：一个账号可以创建多个Bucket，用来分类存放不同用途的文件（比如备份、静态网站、日志）。
Region ID 含义：也叫「区域/地域ID」，是对象存储服务的服务器所在物理区域的标识，必填。作用：部分S3兼容服务（比如AWS S3、阿里云OSS）会根据Region ID 做请求路由，确认你要访问哪个区域的服务，避免跨区域访问出错。示例：阿里云OSS华东1：oss-cn-hangzhou 腾讯云COS广州：ap-guangzhou AWS S3北京：cn-north-1 补充：部分自建S3服务（如MinIO）可以填任意值，不影响使用。
根路径（默认为 /）
尽量不要填/，而是指定Bucket下的子目录
含义：这是「远程存储路径/前缀」，用来指定文件要存放在Bucket下的哪个子目录里。示例：填 /backup/photos/：文件会上传到 Bucket/backup/photos/ 目录下填 /（默认值）：文件会直接存放在Bucket的根目录下作用：可以用这个配置实现“多客户端共享同一个Bucket，但数据互不干扰”，比如A客户端填 /userA/，B客户端填 /userB/，数据就会分开存放。
是否启用含义：这是一个总开关，用来控制这个存储配置是否生效。状态说明：关闭状态（灰色）：这个配置不会被使用开启状态（一般为亮色）：云端会加载这个配置用途：方便你临时停用某个配置，而不用删除或清空上面的所有信息。
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即可
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/

2、笔记空间注意事项

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

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

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

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

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

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

4、应用接续注意事项

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

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

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

5、手写画板注意事项

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

6、防窥保护注意事项

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

7、碰一碰注意事项

仅支持手机与手机、手机与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屏幕，触发碰一碰
如果打开不是应用内部的文档，由于系统权限限制，可能会导致碰一碰失败，如果使用碰一碰功能建议使用内部空间。

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

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

9、PDF生成注意事项

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

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

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

10、编辑器上传注意事项

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

.png
.jpg
.jpeg
.gif
.svg

11、导入注意事项

注意：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设备可以在首页（文件列表模式、文件夹模式）、资源管理等处使用文件夹导入菜单或直接拖拽文件夹的方式导入，手机端只支持拖拽文件夹导入。

12、导出注意事项

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

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

13、分享注意事项

如果想要将用户文件（比如在文件管理中的）.md或.pdf文件使用奕澄Markdown打开编辑，则使用系统文件管理的[分享]功能分享给奕澄Markdown或[其他应用打开]。
目前不支持分享面板直接预览，可点击[导入奕澄]按钮将文件保存到应用里，在md或pdf列表中查看。
如果文件不能分享，则可能是因为被分享端不支持此格式，请发送邮箱lotoze@qq.com反馈。
.md和.pdf类型文件支持华为分享直接预览。
后续会逐渐适配其他常用的app~

14、卸载注意事项

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

15、PDF打印注意事项

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

16、分享到微信注意事项

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

匠心使然，热爱伟大！

愿奕澄与您同行~