https://github.com/vivalucas/mininote
A lightweight plain text editor for macOS, inspired by the Windows 11 Notepad. Persistent tabs that survive restarts, default plain-text paste, Finder integration, and optional Markdown rendering. Simple, focused, distraction-free.
https://github.com/vivalucas/mininote
lightweight macos markdown notepad plain-text productivity swift text-editor
Last synced: 12 days ago
JSON representation
A lightweight plain text editor for macOS, inspired by the Windows 11 Notepad. Persistent tabs that survive restarts, default plain-text paste, Finder integration, and optional Markdown rendering. Simple, focused, distraction-free.
- Host: GitHub
- URL: https://github.com/vivalucas/mininote
- Owner: vivalucas
- Created: 2026-05-07T08:35:15.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-28T11:32:15.000Z (15 days ago)
- Last Synced: 2026-05-28T13:13:27.610Z (15 days ago)
- Topics: lightweight, macos, markdown, notepad, plain-text, productivity, swift, text-editor
- Language: Swift
- Homepage:
- Size: 1.74 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# MiniNote
一个为 macOS 做的轻量纯文本编辑器：打开就写，关了不丢，粘贴永远是干净文字。
[English](README.en.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [繁體中文](README.zh-TW.md) | [Português](README.pt-BR.md) | [Italiano](README.it.md) | [Русский](README.ru.md)
---
## 它适合谁
MiniNote 不是第二个 Obsidian、Typora 或 IDE。它更像一个精致、安静、不会打断你的 macOS 记事本。
适合这些场景：
- 临时记一段文字、一个想法、一条命令。
- 从网页、微信、PDF 里复制内容，顺手清掉格式。
- 同时开很多短文本，第二天继续写，不想管理一堆文件。
- 偶尔打开 `.txt` / `.md` / `.mint` 文件做快速编辑。
- 想要一个轻、快、离线、本地保存的纯文本工具。
## 安装
### Homebrew 推荐
第一次安装：
```bash
brew tap MoeMoeGit/mininote
brew install --cask mininote
```
以后更新：
```bash
brew upgrade --cask mininote
```
如果你不想使用 Homebrew，也可以从 [Releases](https://github.com/vivalucas/mininote/releases) 下载最新的 DMG。
### DMG 手动安装
1. 打开 [Releases](https://github.com/vivalucas/mininote/releases)，下载最新的 `MiniNote-[版本号].dmg`。
2. 打开 DMG，把 `MiniNote.app` 拖进 Applications 文件夹。
3. 从 Applications 启动 MiniNote。
### ZIP 安装
1. 打开 [Releases](https://github.com/vivalucas/mininote/releases)，下载最新的 `MiniNote-[版本号].zip`。
2. 解压后把 `MiniNote.app` 移动到 Applications 文件夹。
3. 从 Applications 启动 MiniNote。
### 首次打开时的 macOS 提示
当前版本还没有完成 Apple Developer ID 公证。安装后首次打开时，macOS 可能提示“无法验证开发者”或“应用已损坏”。这通常是 Gatekeeper 对未公证应用的拦截，不代表安装包损坏。
可选择右键点击 `MiniNote.app`，选择“打开”，再在弹窗里确认打开。也可以在终端执行：
```bash
xattr -cr /Applications/MiniNote.app
```
正式公证完成后，这一步会移除。
## 主要功能
### 标签页会自动恢复
新建标签页后直接写，不需要先命名或保存。关闭窗口、重启电脑，之前的标签页和内容都会回来。
### 写作和保存是分开的
MiniNote 会实时保存你的会话，防止内容丢失；只有你按 `Cmd+S` 时，才会把内容写回磁盘文件。这意味着临时记录可以一直留在 MiniNote 里，而正式文件仍由你决定什么时候保存。
### 粘贴默认就是纯文本
从网页、聊天软件、PDF 或富文本编辑器复制内容进来，MiniNote 会自动去掉格式，只留下干净文字。
### Markdown 可看可写
默认是纯文本编辑。按 `Cmd+R` 可以切换到 Markdown 预览，再按一次回到编辑状态。适合快速检查标题、列表、引用、代码块等基础结构。
### Finder 和 Quick Look 支持
MiniNote 支持 `.mint`、`.txt`、`.md` 三种纯文本格式，并提供 Finder 右键新建 MiniNote 文档和 Quick Look 预览能力。
## 常用快捷键
| 操作 | 快捷键 |
|------|--------|
| 新建标签页 | `Cmd+N` |
| 快速便签 | `Cmd+Shift+N` |
| 打开文件 | `Cmd+O` |
| 保存 | `Cmd+S` |
| 另存为 | `Cmd+Shift+S` |
| 关闭标签页 | `Cmd+W` |
| 查找 | `Cmd+F` |
| 查找替换 | `Cmd+Option+F` |
| Markdown 预览 | `Cmd+R` |
| 设置 | `Cmd+,` |
## 支持的格式
| 格式 | 用途 |
|------|------|
| `.mint` | MiniNote 默认文档类型，本质是 UTF-8 纯文本 |
| `.txt` | 标准纯文本文件 |
| `.md` | Markdown 文件 |
三种格式都可以用其他文本编辑器打开。MiniNote 的标签页顺序、光标位置、预览状态等信息保存在本地 session 中，不会写进文件内容。
## 使用提示
- 用 `Cmd+N` 新建一个临时标签页，直接开始写。
- 用 `Cmd+Shift+N` 快速创建一个空白便签。
- 用 `Cmd+S` 把当前内容保存成文件。
- 用 `Cmd+Shift+S` 在 `.mint`、`.txt`、`.md` 之间转换。
- 拖拽标签页可以调整顺序。
- 状态栏会显示行列、字符数、文件类型、换行符、保存状态等信息。
- 在设置里可以切换浅色、深色或跟随系统主题。
## 系统要求
- macOS 26 Tahoe 或更高版本
- Apple Silicon Mac，M 系列芯片
## 数据存在哪里
MiniNote 是本地应用，不上传内容，不做云同步。
临时标签页和会话数据保存在：
```text
~/Library/Application Support/MiniNote/sessions/
```
已经保存到磁盘的文件仍在你选择的位置，MiniNote 不会把它们搬走。
## 常见问题
**`.mint` 和 `.txt` 有什么区别？**
内容本质一样，都是 UTF-8 纯文本。`.mint` 是 MiniNote 的默认文件类型，更适合便签和草稿；`.txt` 是通用纯文本格式。
**为什么有时候关闭标签页会提示保存？**
关闭整个窗口会保留所有标签页；关闭单个有改动的标签页时，MiniNote 会确认你是否要保存到磁盘或丢弃这个标签页。
**支持语法高亮吗？**
不支持。MiniNote 的定位是纯文本编辑器。Markdown 预览只做基础渲染，不做代码语法高亮。
**支持云同步吗？**
不支持。MiniNote 只做本地文本编辑和本地会话恢复。
## 开发
技术栈：Swift 6 + SwiftUI + NSTextView / TextKit，无第三方依赖。
```bash
git clone https://github.com/vivalucas/mininote.git
open MiniNote.xcodeproj
```
用 Xcode 打开后选择自己的开发者账号即可本地构建运行。
## License
MIT License