Obsidian 学习笔记

Appearance

安装与配置问题 ​

这里汇总了 Obsidian 安装和配置过程中最常见的问题。

📥 下载与安装 ​

Obsidian 支持哪些操作系统？ ​

Obsidian 支持以下操作系统：

平台最低版本下载方式
WindowsWindows 10+官网/应用商店
macOSmacOS 10.15+官网/App Store
Linux主流发行版官网/Flatpak/Snap
iOSiOS 14+App Store
AndroidAndroid 8.0+Play Store/APK

如何下载 Obsidian？ ​

官方渠道：

  1. 官网：https://obsidian.md
  2. GitHub：https://github.com/obsidianmd/obsidian-releases
  3. 应用商店：各平台官方应用商店

注意

请务必从官方渠道下载，避免使用第三方来源的安装包。

安装时提示权限错误怎么办？ ​

Windows：

bash
# 解决方案：
1. 右键以管理员身份运行
2. 关闭杀毒软件后重试
3. 检查安装路径是否有特殊字符

macOS：

bash
# 如果提示"无法打开，因为它来自身份不明的开发者"：
1. 系统偏好设置 → 安全性与隐私 → 仍要打开
2. 或在终端执行: xattr -cr /Applications/Obsidian.app

Linux：

bash
# 如果提示权限问题：
sudo chmod +x obsidian.AppImage
# 或使用 Flatpak/Snap 安装

如何在多台设备上安装？ ​

mermaid
graph TD
    A[选择同步方案] --> B{官方同步?}
    B -->|是| C[购买同步服务]
    B -->|否| D[配置第三方同步]
    C --> E[在各设备登录]
    D --> E
    E --> F[下载远程仓库]
    F --> G[开始使用]

🗂️ 仓库管理 ​

什么是仓库（Vault）？ ​

仓库是 Obsidian 存储笔记的文件夹，包含：

  • 笔记文件（.md）
  • 附件文件
  • 配置文件（.obsidian 文件夹）
  • 插件和主题

如何创建新仓库？ ​

方法一：创建空仓库

  1. 点击"创建新仓库"
  2. 选择存储位置
  3. 输入仓库名称
  4. 点击创建

方法二：打开现有文件夹

  1. 点击"打开文件夹作为仓库"
  2. 选择包含 .md 文件的文件夹
  3. Obsidian 会自动识别

如何迁移仓库到新位置？ ​

步骤：

  1. 关闭 Obsidian
  2. 复制整个仓库文件夹到新位置
  3. 打开 Obsidian，选择"打开文件夹作为仓库"
  4. 选择新位置的文件夹

重要

确保复制完整的 .obsidian 文件夹，否则配置和插件会丢失。

如何在多台电脑间共享仓库？ ​

推荐方案：

方案优点缺点
Obsidian Sync官方支持，稳定需付费
Git + Obsidian Git免费，版本控制需技术基础
iCloud/OneDrive简单可能有冲突
Syncthing免费，P2P需配置

⚙️ 初始配置 ​

首次使用需要配置什么？ ​

基础配置清单：

必做：

  • 选择外观主题
  • 设置默认编辑器模式
  • 配置附件存储位置

推荐：

  • 启用核心插件（日记、模板等）
  • 设置快捷键
  • 配置备份方案

可选：

  • 安装第三方插件
  • 自定义 CSS
  • 配置同步

如何设置中文界面？ ​

  1. 打开设置 → 外观
  2. 找到"语言"选项
  3. 选择"简体中文"
  4. 重启 Obsidian

如何配置附件存储？ ​

推荐设置：

  1. 设置 → 文件与链接
  2. "新附件的默认位置"选择"指定文件夹"
  3. 设置文件夹路径，如 Attachments/

按年月归档：

text
Attachments/
├── 2024/
│   ├── 01/
│   ├── 02/
│   └── ...

如何设置自动备份？ ​

使用 Obsidian Git 插件：

  1. 安装 Obsidian Git 插件
  2. 配置 Git 仓库
  3. 设置自动备份间隔（建议 10-30 分钟）
  4. 配置自动推送

🐧 Linux 安装详解 ​

安装方式对比 ​

方式优点缺点自动更新
AppImage无需安装、便携需手动下载更新❌
Flatpak沙箱隔离、自动更新体积较大✅
Snap自动更新、隔离启动较慢✅
AUR (Arch)系统包管理仅 Arch 系✅

AppImage 安装 ​

bash
# 下载最新版
wget https://github.com/obsidianmd/obsidian-releases/releases/latest/download/Obsidian-x.y.z.AppImage

# 添加执行权限
chmod +x Obsidian-*.AppImage

# 运行
./Obsidian-*.AppImage

提示

如果 AppImage 无法运行，可能需要安装 FUSE：sudo apt install libfuse2

Flatpak 安装 ​

bash
# 安装
flatpak install flathub md.obsidian.Obsidian

# 运行
flatpak run md.obsidian.Obsidian

Snap 安装 ​

bash
# 安装
sudo snap install obsidian --classic

# 运行
obsidian

Linux 桌面集成 ​

创建桌面快捷方式：

bash
# 创建 .desktop 文件
cat > ~/.local/share/applications/obsidian.desktop << 'EOF'
[Desktop Entry]
Name=Obsidian
Exec=/path/to/Obsidian.AppImage
Type=Application
Icon=obsidian
Categories=Office;
EOF

常见 Linux 问题 ​

中文输入法无法使用？

  • Fcitx5：设置环境变量 GTK_IM_MODULE=fcitx
  • IBus：确保 ibus-daemon 正在运行
  • 在启动命令中添加：--enable-features=UseOzonePlatform --ozone-platform=wayland（Wayland 环境）

字体渲染模糊？

bash
# 安装中文字体
sudo apt install fonts-noto-cjk

# 或手动安装字体后清除缓存
fc-cache -fv

Wayland 下无法输入中文？

在 .desktop 文件的 Exec 行添加：

text
Exec=env GTK_IM_MODULE=fcitx /path/to/Obsidian.AppImage --enable-features=UseOzonePlatform --ozone-platform=wayland

代理配置 ​

如果在网络受限环境中安装：

bash
# 临时设置代理
export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890

# 然后运行安装命令
flatpak install flathub md.obsidian.Obsidian

对于 Obsidian 内部网络请求（如同步），在设置 → 代理中配置。

🔧 高级配置 ​

如何导入其他笔记软件的数据？ ​

来源导入方法
Notion使用导入插件或 Markdown 导出
Evernote使用导入插件
Roam Research导出为 Markdown
Logseq直接打开文件夹
印象笔记使用第三方转换工具

如何重置 Obsidian 配置？ ​

方法一：删除配置文件夹

bash
# 关闭 Obsidian 后删除
.obsidian/

# 重启后会生成默认配置

方法二：仅重置特定配置

bash
# 只删除主题配置
.obsidian/themes/
.obsidian/appearance.json

# 只删除插件配置
.obsidian/plugins/

如何导出配置？ ​

手动导出：

  1. 复制 .obsidian 文件夹
  2. 保存到安全位置

使用插件导出：

  1. 安装"Settings Export"插件
  2. 导出配置为 JSON 文件

❓ 其他问题 ​

安装后打开是空白页面？ ​

解决方案：

  1. 检查是否安装了最新版本
  2. 清除缓存后重启
  3. 尝试以兼容模式运行（Windows）
  4. 检查是否被防火墙阻止

如何查看 Obsidian 版本？ ​

  1. 打开设置 → 关于
  2. 查看当前版本号

如何更新到最新版本？ ​

自动更新：

  • 桌面端：设置 → 关于 → 检查更新
  • 移动端：应用商店自动更新

手动更新：

  • 下载最新安装包
  • 直接覆盖安装（配置不会丢失）

卸载后笔记会丢失吗？ ​

不会！ 你的笔记存储在仓库文件夹中，不在软件安装目录。卸载 Obsidian 不会删除笔记。

建议

卸载前记住仓库位置，重装后直接打开该文件夹即可。

🔗 相关链接 ​

提示

如果以上内容没有解决你的问题，请查看故障排查指南或在社区求助。