Obsidian 学习笔记

Appearance

Terminal 插件使用指南 ​

Terminal 是 Obsidian 中用于在笔记内部直接运行 Shell 命令的插件，支持多标签页、历史记录和常用命令快捷方式。

插件特点 ​

特性说明
💻 内嵌终端在 Obsidian 面板中运行命令
📑 多标签页支持多个终端标签
📜 命令历史记录和复用历史命令
⚡ 快捷命令保存常用命令快速执行
🔗 笔记集成命令输出可直接插入笔记

安装插件 ​

  1. 打开「设置」→「第三方插件」→ 关闭「安全模式」
  2. 点击「浏览」→ 搜索「obsidian-terminal」→ 安装并启用

基础配置 ​

打开终端 ​

方法操作
命令面板Terminal: Open terminal
快捷键默认 Ctrl + `` （反引号）
左侧边栏点击 Terminal 图标

终端面板 ​

┌──────────────────────────────────────────────────┐
│ [+] [bash] [zsh] [powershell]      [×] [⛶]     │
├──────────────────────────────────────────────────┤
│ user@obsidian:~/Vault $ █                         │
│                                                  │
│                                                  │
│                                                  │
│                                                  │
├──────────────────────────────────────────────────┤
│ history │ shortcuts │ new tab │ settings        │
└──────────────────────────────────────────────────┘

基础命令 ​

导航命令 ​

命令说明
pwd显示当前目录
cd <path>切换目录
ls列出文件
ls -la详细列表
find . -name "*.md"搜索 Markdown 文件

文件操作 ​

命令说明
cat file.md查看文件内容
head -n 20 file.md显示前 20 行
tail -n 10 file.md显示末尾 10 行
grep "关键词" file.md搜索关键词

Git 命令 ​

命令说明
git status查看状态
git log --oneline查看提交历史
git diff查看变更
git add .添加所有变更

多标签页 ​

新建标签 ​

  • 点击 + 按钮
  • 或使用快捷键 Ctrl + Shift + T

切换标签 ​

  • 点击标签栏切换
  • 或使用 Ctrl + Tab / Ctrl + Shift + Tab

标签操作 ​

操作命令
关闭标签Ctrl + W
重命名标签双击标签名
复制标签右键 → Duplicate

命令历史 ​

查看历史 ​

点击底部 history 或使用 ↑ / ↓ 键浏览历史命令。

搜索历史 ​

Ctrl + R 打开历史搜索，输入关键词快速匹配。

历史配置 ​

在设置中可配置：

  • 最大历史记录数（默认 1000）
  • 是否忽略敏感命令
  • 历史持久化

快捷命令 ​

创建快捷命令 ​

  1. 打开设置 → Terminal → Shortcuts
  2. 点击 Add
  3. 配置命令和触发词

示例快捷命令 ​

触发词命令说明
todaycd Journal/Daily && ls -t | head -1打开今日日记
syncgit add . && git commit -m "auto"自动提交
findmdfind . -name "*.md" | wc -l统计笔记数
sizedu -sh .查看仓库大小

使用快捷命令 ​

在终端中输入触发词即可执行对应命令。

笔记集成 ​

插入命令输出 ​

  1. 在笔记中输入 ``terminal 创建代码块
  2. 输入要执行的命令
  3. 点击运行按钮或使用 Ctrl + Enter
terminal
```bash
ls -la
```

输出自动插入 ​

运行命令后，点击「Insert output into note」，结果自动插入到笔记中。

使用场景 ​

快速查找笔记 ​

bash
# 在仓库中搜索关键词
grep -r "Obsidian" . --include="*.md" | head -20

# 搜索特定标签
grep -r "#项目" . --include="*.md" | wc -l

批量重命名 ​

bash
# 将所有 .txt 文件改为 .md
for f in *.txt; do mv "$f" "${f%.txt}.md"; done

数据统计 ​

bash
# 统计各类型文件数量
echo "=== 文件统计 ===" && \
find . -type f -name "*.md" | wc -l && echo "Markdown 文件" && \
find . -type f -name "*.pdf" | wc -l && echo "PDF 文件"

Git 工作流 ​

bash
# 快速提交
git add . && git status

# 查看今日变更
git diff --stat $(git log -1 --format="%H")

配置选项 ​

选项说明默认值
Shell使用的 Shell 程序bash
Starting directory起始目录Vault 根目录
Font size字体大小14px
Theme终端主题与 Obsidian 同步
Scrollback历史记录行数10000

常见问题 ​

Q: 终端无法启动？ ​

  1. 确认系统安装了 bash/zsh
  2. 检查插件设置中的 Shell 路径
  3. 重启 Obsidian

Q: 命令输出乱码？ ​

在设置中调整字符编码为 UTF-8。

Q: 如何使用 Windows PowerShell？ ​

在设置中将 Shell 改为 powershell.exe。

Q: 快捷命令不生效？ ​

检查触发词是否唯一，确认命令语法正确。