需完成下载、拖入应用、首次配置三阶段操作：从官网下载universal版.dmg文件，拖拽至“应用程序”文件夹安装，启动后创建位于icloud云盘的笔记库并验证渲染与中文支持。
如果您希望在 macOS 系统上成功安装 Obsidian 并启动首个笔记库，则需完成下载、拖入应用、首次配置三阶段操作。以下是具体执行步骤：
一、下载 Obsidian 安装包
此步骤确保获取官方签名、兼容当前 macOS 版本的最新安装文件。Obsidian 官方不通过 Mac App Store 分发，必须从其官网直接下载 Universal 版本以保障功能完整性。
1、打开 Safari 或其他浏览器，访问 https://obsidian.md 官方网站。
2、在首页点击 “Download for macOS” 按钮。
3、等待下载完成，文件名通常为 Obsidian-*.dmg（如 Obsidian-1.9.12.dmg），默认保存至“下载”文件夹。
二、安装 Obsidian 应用程序
macOS 的 .dmg 文件需手动拖拽安装，该方式绕过 Gatekeeper 二次验证限制，并确保应用拥有完整文件系统访问权限，为后续 Vault 创建与插件运行提供基础支持。
1、双击已下载的 Obsidian-*.dmg 文件，挂载磁盘映像。
2、在弹出的窗口中，将 Obsidian 图标拖拽至“应用程序”文件夹图标上。
3、系统提示“是否要将其添加到应用程序文件夹？”时，点击“是”。
4、关闭磁盘映像窗口，可在“应用程序”文件夹中确认 Obsidian.app 已存在。
三、创建并初始化笔记库（Vault）
Obsidian 启动即要求指定 Vault 路径，该路径决定所有笔记文件的物理存储位置；选择 iCloud 同步目录可实现 Mac 与 iPhone/iPad 间无缝跨设备访问，无需额外插件。
1、打开“应用程序”文件夹，双击 Obsidian.app 启动软件。
2、首次运行时，点击 “Create a new vault”。
一款AI音频处理工具，主要用于MiniMax统一媒体生成技能，用于TokenPlan工作流。当用户要求生成音频、语音、TTS、旁白、图片、插图、姿势等媒体内容时使用，适合需要提升相关任务效率的用户。
3、在弹出窗口中，点击 “Choose another folder”，导航至目标位置：
• 推荐路径：~/Library/Mobile Documents/com~apple~CloudDocs/Obsidian-Vault（即 iCloud 云盘下的 Obsidian-Vault 文件夹）；
• 若未提前创建，请先在 Finder 中进入 iCloud 云盘，新建名为 Obsidian-Vault 的文件夹，再在此处选中它。
4、输入 Vault 名称（例如 My Knowledge Base），点击“创建”。
四、验证安装与基础设置
此步骤确认核心功能就绪，包括界面响应、自动保存、Markdown 渲染及中文支持，避免因语言或权限问题导致后续操作异常。
1、进入主界面后，点击左侧边栏顶部的 “新建笔记” 按钮。
2、在编辑区输入测试内容，例如：**这是加粗文本**，*这是斜体文本*，- 这是列表项。
3、按 Cmd + P 呼出命令面板，输入 “Toggle preview” 并回车，确认预览模式正确渲染格式。
4、进入设置（左下角齿轮图标），在 “Appearance → Language” 中确认语言已设为 “简体中文”。
五、启用 iCloud 同步（可选但推荐）
iCloud 同步依赖于 Vault 物理位置位于 iCloud 云盘内，系统级同步机制自动处理文件增删改，无需配置插件或鉴权，适用于纯文本 Markdown 文件且无额外网络依赖。
1、确认 Vault 文件夹已在 Finder 中显示于 “iCloud 云盘 → Obsidian-Vault” 路径下。
2、在 Finder 中右键点击该文件夹，选择 “显示简介”，检查“共享与同步”区域是否显示 “已启用 iCloud 云盘”。
3、在 Obsidian 中新建一篇笔记，输入内容后等待约 10–30 秒，在 iPhone 的 Obsidian App 中打开同一 Vault，确认笔记实时出现。
