Scratch：极简离线 Markdown 笔记

项目简介

Scratch 是一款极简、离线优先的 Markdown 笔记应用，支持 macOS、Windows 和 Linux。它没有云端、不需要账号、不依赖网络，所有笔记都以纯 .md 文件的形式保存在你自己的磁盘上。应用使用 Tauri + React + TipTap 构建，体积比 Obsidian、Notion 轻量 5–10 倍。

主要功能

• 离线优先：无云同步、无账号、无需联网
• Markdown 存储：笔记就是普通的 .md 文件，完全归你所有
• 所见即所得编辑：富文本编辑，保存为 Markdown
• 预览模式：拖拽或「打开方式」直接打开任意 .md 文件，无需笔记文件夹
• Markdown 源码模式：Cmd+Shift+M 切换查看与编辑原始 Markdown
• 语法高亮：支持 20 种语言，GitHub 风格配色
• Mermaid 图表：在围栏代码块中渲染流程图、时序图等
• KaTeX 数学公式：渲染块级 $$...$$ 公式
• Wikilinks：输入 [[ 通过自动补全在笔记之间建立链接
• 斜杠命令：输入 / 快速插入标题、列表、代码块、图表等
• 专注模式：Cmd+Shift+Enter 淡出侧边栏与工具栏，沉浸写作
• AI 辅助编辑：可用本地的 Claude Code、OpenAI Codex、OpenCode 或 Ollama CLI 编辑笔记（Ollama 可全程离线），并能检测外部文件改动，兼容其他 AI agent
• 文件夹：可选启用的可折叠目录树，支持拖拽整理笔记
• 键盘优化：大量快捷键与命令面板
• 可定制：主题、排版、页面宽度与 RTL 文字方向
• Git 集成：可选的版本控制，通过 push/pull 在多设备间同步

安装与使用

macOS

Homebrew（推荐）：

brew tap erictli/tap
brew install --cask erictli/tap/scratch

手动安装：从 Releases 下载最新的 .dmg，打开后将 Scratch 拖入「应用程序」，再从「应用程序」启动。

Windows

从 Releases 下载最新的 .exe 安装包并运行；如需 WebView2 会自动下载。

Linux

从 Releases 下载最新的 .AppImage 或 .deb。

从源码构建

前置要求：Node.js 18+、Rust 1.70+；macOS 需 Xcode Command Line Tools，Windows 需 WebView2 Runtime（Windows 11 已预装）。

git clone https://github.com/erictli/scratch.git
cd scratch
npm install
npm run tauri dev      # 开发
npm run tauri build    # 生产构建

常用快捷键

快捷键	功能
Cmd+N	新建笔记
Cmd+D	复制笔记
Cmd+Backspace	删除笔记
Cmd+P	命令面板
Cmd+K	添加/编辑链接
Cmd+F	笔记内查找
Cmd+Shift+M	切换 Markdown 源码
Cmd+Shift+Enter	切换专注模式
Cmd+Shift+F	搜索笔记
Cmd+,	打开设置
Cmd+\	切换侧边栏
Cmd+B/I	加粗/斜体
Cmd+=/-/0	放大/缩小/重置缩放

Windows 上请将 Cmd 换成 Ctrl。更多快捷键可在命令面板（Cmd+P / Ctrl+P）或「设置 → 快捷键」中查看。

注意事项

• 项目已发布 1.0 稳定版，作者不再定期关注 issue 与 PR，因此不保证处理所有反馈；有较大改动需求时建议自行 fork。
• 项目采用 MIT 许可证。
• Scratch 有意保持极简的功能集，不以成为 Obsidian 或 Notion 为目标。

---

本作品整理自 GitHub 开源项目 erictli/scratch，原作者 @erictli。中文介绍由 AI 根据项目 README 整理，以原仓库为准。