# @adrianmg/noted 中文文档

规范地址：https://npmcn.com/package/%40adrianmg/noted/

版本：1\.9\.0
npm 元数据更新时间：2026-11-04T05:10:48.169Z
中文译文更新时间：2026-11-07T03:35:56.644Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adrianmg/noted
原文对照：https://npmcn.com/package/%40adrianmg/noted/?lang=original
项目主页：https://noted.computer/
源码仓库：https://github.com/adrianmg/noted

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：8.6 MB，10 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-10-25T21:36:06.391Z
- 最新版本发布：2026-11-04T05:10:47.984Z
- 近 30 天下载量：2067（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

在您的终端中标记下音符, 仿佛在 MS- DOS 上运行: 以 2.5 ms 打开, 保存在您键入时, 并保留每个音符为平方 . md 文件 .

## 安装

```sh
npm install @adrianmg/noted
```

也可以使用：`pnpm add @adrianmg/noted`、`yarn add @adrianmg/noted`、`bun add @adrianmg/noted`

## README

# ![noted's logo: a floppy disk](https://raw.githubusercontent.com/adrianmg/noted/main/docs/logo.png)  
说明

在你的终端做标记, 仿佛他们运行在MS -DOS.  
以 2. 5 ms 为单位打开,在您输入时保存,将每个音符保存为普通的Markdown文件.

[![npm version](https://img.shields.io/npm/v/%40adrianmg%2Fnoted?label=npm&color=0000aa)](https://www.npmjs.com/package/@adrianmg/noted) [![Latest release](https://img.shields.io/github/v/release/adrianmg/noted?label=release&color=00aaaa)](https://github.com/adrianmg/noted/releases) [![Website: noted.computer](https://img.shields.io/badge/website-noted.computer-ffff55)](https://noted.computer/)

  
![noted starting from the shell: a new note with a task list, ticking a task, the notes list, finding a note as you type, then the Amber theme](https://raw.githubusercontent.com/adrianmg/noted/main/docs/demo.gif)  

## 安装

```sh
# npm: macOS, Linux and Windows (Node 18 or newer)
npm install -g @adrianmg/noted

# Homebrew: macOS and Linux
brew tap adrianmg/noted https://github.com/adrianmg/noted
brew trust adrianmg/noted
brew install noted

# Install script: checks the build against the release's checksums
curl -fsSL https://noted.computer/install | sh      # macOS, Linux
irm https://noted.computer/install.ps1 | iex        # Windows, in PowerShell
```

如果 npm 警告安装脚本被屏蔽, 注意仍然被安装 : 运行 `noted`. 可选脚本提高了macOS和Linux的启动速度. 为了允许优化, 重新安装 npm 版本, 支持 `--allow-scripts`数字 :

```sh
npm install -g @adrianmg/noted --allow-scripts=@adrianmg/noted
```

## 使用量

```sh
noted                     # a new note, cursor ready
noted buy oat milk        # a new note that starts with those words
noted --theme amber       # system, turbo, amber, charcoal, c64,
                          # midnight, phosphor, ayu, catppuccin, cobalt2,
                          # darcula, dracula, githubdark, gruvbox, gruvboxlight,
                          # nord, redsands, solarized, synthwave
noted --dir ~/Notes       # keep notes in another folder this time
noted --path              # print where your notes are
noted --help              # every option
```

## 导入已存在的笔记或更改位置

在 Obsidian 、 iA Writer 或其他保存的应用程序中已有注释 马克德? 打开他们的文件夹 `--dir`; 有空格的引用路径 :

```sh
noted --dir ~/Notes
noted --dir "$HOME/Documents/My Notes"
```

现有笔记已打开,包括嵌入式文件夹中的笔记和新的 音符被保存在那里。 没有单独的导入或转换步骤. `--dir` 仅适用于此运行: 它不更改默认或移动 您的上一个文件夹中的注释 .

要永久更改默认, 请使用 Noted QQ Notes 文件夹... 当前 位置显示为只读,“要使用的文件”从该路径开始. **使用新文件夹** 当您选择一个有效的、不同的 地点. **把已有的笔记取出 '...'** 然后让您移动当前 或随笔而出,或随笔而出。 现有附注 ; 取消任何更改.

## 它会做什么

注意在2.5毫秒左右的新音符上打开,每键在0.1毫秒以下回答 (大约0.1毫秒在一个 三万行注), 并节省当你键入, 所以没有 保存按钮和没有损失。 每个音符是一个简单的Markdown文件,命名为 在它的第一行之后,在一个 `Noted` 打开时在 iCloud 驱动器中的文件夹,或 其他文档中,任何编辑器都可以打开: `noted --path` 指纹,其中, 和注解文件夹... 选择打开并保存的注解 。 Markdown在你打字的时候被点燃了, 查找您输入的每个音符, 并且看起来都像 MS- DOS : 拉下菜单,诺顿指挥板和13个主题,其中一个在 您的终端本身的颜色(xterm's on Windows). 它运行于 macOS, Linux 和 视窗,在任何终端.

如何与Apple Notes、Obsidian、VS代码、vim和Emacs进行对比 在一个Mac上,每个样本都公布: [基准](https://github.com/adrianmg/noted/tree/main/benchmarks)。 。 。 .

## 密钥

| 密钥 |  |
| --- | --- |
| `ESC` | 笔记列表, 并返回 |
| `⌘F` 或者说 `^F` | 查找音符,或创建音符 |
| `^N` | 新注释 |
| `^T` | 做一个任务,选中它 |
| `^G` | 插入一个表格 |
| `⌥↩` 或者说 `⌥`\- 点击 | 在光标处查看图像 |
| `^D` | 删除注释(倒入回收站; `^Z` 放回来 |
| `F10` | 菜单 |
| `F1` | 每把钥匙 |
| `^Q` | 退出 |

在个人电脑上,读取 `⌘` 作为 `^` 财务报告和审定财务报表 `⌥` 作为 `ALT`。 。 。 .

### Vim 密钥

选项 QQ Vim 密钥 (`⌥O` 接下来 `m`)转出音符模式,如vim. 关了 直到你打开它。 页脚显示模式,光标是 插入模式 。 一个新的音符开始于“插入”模式,一个打开的“正常”模式.

| 密钥 |  |
| --- | --- |
| `i` `a` `I` `A` `o` `O` | 插入模式; `ESC` 离开它 |
| `h` `j` `k` `l` `w` `b` `e` `0` `^` `$` `gg` `G` `f` `t` `{` `}` `%` | 移动, 计数 : `3w` `5j` |
| `d` `c` `y` | 带有动议或文本对象: `dw` `c$` `yy` `dd` `ciw` `ci"` `da(` |
| `x` `D` `C` `s` `p` `P` `r` `~` `J` `>>` `<<` | 像Vim一样 |
| `u` `^R` | 撤消、 重做; 整个插入是一步 |
| `/` | 在你的笔记上发现了 |

在注释列表中, `j` `k` 下而上而来. 这是Vim的核心,检查 对Vim本身,不是全部: 没有视觉模式(`v`, (中文(简体) ), `.`, (中文(简体) ), 登记册、标记、宏或 `:` 命令,而一个密钥vim有这个 脚印上可没这么说. `^` 钥匙留名,所以 `^F` 发现和 `^D` 删除注释.

## 更新

```sh
npm install -g @adrianmg/noted     # npm
brew upgrade noted                 # Homebrew
```

用安装脚本,再运行一次.

## 为什么?

一个想法在几秒钟内就消失了 大多数笔记应用需要更长的时间 打开。注意的是一个终端,在按完 Enter 之前准备好,并且 仅将普通文件保存在您拥有的文件夹中.

你想知道更多吗? [访问已注意到](https://noted.computer/), (中文(简体) ), 使用现场演示和用户指南.

## 有问题吗? 想法吗? 虫子吗?

[打开一个问题](https://github.com/adrianmg/noted/issues) 要么打我 要么打我 要么打我 上来 [微博](https://twitter.com/adrianmg)。 。 。 .

该存储库保存有已注意到的版本、其母体配方和这个README; npm 软件包, [@ adriamg/ 注意到](https://www.npmjs.com/package/@adrianmg/noted), (中文(简体) ), 同样的造型,从这里出版,有出处。 报告 一种脆弱性,见 [警卫](https://github.com/adrianmg/noted/blob/main/SECURITY.md)。 。 。 .

## 许可证

由 [阿德里安·马托](https://adrianmato.com/). 根据《公约》条款提供 页:1 [MIT 许可证](https://github.com/adrianmg/noted/blob/main/LICENSE)。 。 。 .

## 常见问题

### @adrianmg/noted 是什么？

在您的终端中标记下音符, 仿佛在 MS- DOS 上运行: 以 2\.5 ms 打开, 保存在您键入时, 并保留每个音符为平方 \. md 文件 \.

### 如何安装 @adrianmg/noted？

在项目目录运行 npm install @adrianmg/noted，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 noted，可以用 npx noted 直接运行。

### @adrianmg/noted 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/adrianmg\_\_noted 是否存在。

### @adrianmg/noted 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @adrianmg/noted 可以商用吗？

@adrianmg/noted 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @adrianmg/noted 的下载量有多少？

根据 npm 官方下载统计，@adrianmg/noted 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,067 次，日均约 69 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adrianmg/noted 还在维护吗？

最新版本 1\.9\.0 发布于 2026/11/04（3 天前）；至今共发布 12 个版本，其中过去 12 个月发布了 12 个；首次发布于 2026/10/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

