“写笔记”支持四种格式——Word 文档、Excel 表格、Markdown、纯文本,起稿或二次编辑时都能随时切换,同一篇笔记想用哪种形态来记,都由你说了算。
md、txt、csv、json 这类纯文本则原样载入,不做多余加工。拿一张现成的表倒进来、改几笔、再导出去,等于白用一台免费的格式转换器。
要带走就在右上角点“下载”,可导出 PDF、Word、Markdown、Excel、TXT 等格式;列表卡片“⋯”菜单里,也有同样的下载入口。
在“工具”页点“+ 上传工具”即可发布:填好名称与链接,再用 Markdown 把使用方法写清楚——能解决什么问题、怎么装、怎么用,比堆介绍实在。
要分发安装包就一并上传压缩包(ZIP、RAR、7Z、TAR.GZ,最大 35MB),别人在详情页一键下载;只放链接不带附件也可以。
工具按大家的收藏热度排序,好用的自然会被顶上来。发布后可在详情页或卡片菜单里编辑、下架。
写笔记时勾上“隐藏”,这篇就只存在于你自己的账号里:不进列表、不进搜索、不上首页精选,也不会出现在任何公开的页面,链接发给别人同样打不开。
适合放密码、草稿、日记这类只给自己看的内容;想公开,去“发布”打开它,把“隐藏”的勾去掉再保存,之后编辑会默认保持原状态,不会悄悄变回公开。
你的内容会同时保存在多个副本上,系统定期做备份与完整性校验,再配合异地容灾机制:就算某台机器出问题,数据也不会丢,可以长期放心存放;特别重要的资料,仍建议你另外再留一份备份。
全站跑在容器化、模块化的现代架构上,更新、部署、回滚都很快,扩展性和稳定性都按长期运营的标准来设计(Built for reliability, designed to scale)。
这个网站最早只是一个人的笔记仓库,后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法,只是干干净净地存放一些东西;既然做好了,就公开出来,万一有人用得上呢。
不做大而全,不做平台梦,保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护:不会突然冒出付费墙,不会在角落塞广告位,也不会把你的数据卖给第三方。
产品会持续迭代,站内日志页记录着每一次改动,改了什么都有迹可循;想了解这个站是怎么一步步走到今天的,翻翻日志就能看到来龙去脉。
如果在这里看到涉嫌违规的内容,点对应卡片右侧的“举报”按钮就能提交,我们会尽快核实处理;也谢谢你花一点时间,一起把这里维护干净。
tealdeer
tealdeer — 一个超快的 Rust 版 tldr 客户端,秒速帮你查命令用法,告别 man 手册的冗长折磨。
如果你跟我一样,是个天天泡在终端里的开发者,肯定有过这种经历:明明记得某个命令能干活,但具体参数是 -a 还是 -A,死活想不起来。这时候你大概率会 man xxx,然后面对一屏幕密密麻麻的英文文档,翻半天才找到想要的那一行——更别提有些 man 手册写得跟天书似的。
我之前试过 tldr(Too Long, Didn't Read),理念很好:把命令的常用场景和参数浓缩成几个简洁的示例。但官方的 Node.js 版启动有点慢,尤其我这种急性子,敲完命令到看到输出,那零点几秒的延迟都让我抓狂。直到我发现了 tealdeer——一个用 Rust 写的 tldr 客户端,快得离谱,几乎秒出结果。
它到底快在哪?
tealdeer 的核心优势就一个字:快。Rust 编译成原生二进制,没有 Node.js 的启动开销,没有 Python 的解释延迟。我自己实测,在同样网络缓存好的情况下,tealdeer 显示一个命令示例大概在 10-20 毫秒,而官方 tldr 客户端要 200-300 毫秒。如果你经常在终端里查命令,这个差距体感非常明显——就像从机械硬盘换到 NVMe 固态。
当然,快只是表象。它本质上是一个 tldr 客户端的实现,所以它能解决的核心问题是:让你用最少的阅读成本,快速掌握一个命令的常用用法。比如你想知道 tar 怎么解压 .tar.gz,不用去 man 手册里翻 -xzvf 到底哪个字母在前面,tealdeer 直接给你一个示例:
$ tar -xzf archive.tar.gz
干净利落。
下载与安装
tealdeer 的安装方式非常灵活,而且跨平台(Linux、macOS、Windows 全支持)。我推荐几种最省事的方法:
1. 包管理器安装(最推荐)
- macOS (Homebrew):
brew install tealdeer - Linux (各大发行版):
- Arch Linux:
pacman -S tealdeer - Fedora:
dnf install tealdeer - Ubuntu/Debian:
apt install tealdeer(注意:Ubuntu 官方源版本可能较旧,建议用下面 cargo 方式)
- Arch Linux:
- Windows (Scoop):
scoop install tealdeer - Windows (Winget):
winget install tealdeer
2. 从 GitHub Releases 下载二进制
如果你不想用包管理器,或者系统源里没有,可以直接去 tealdeer GitHub Releases 页面下载对应平台的二进制文件,解压后放到 PATH 里就行。比如 Linux x86_64 就下载 tealdeer-linux-x86_64-musl.tar.gz,这个版本用了 musl 静态编译,不依赖系统 glibc,兼容性极好。
3. 用 Cargo 编译安装(需要 Rust 环境)
如果你本身就是 Rust 开发者,或者想体验最新版:
cargo install tealdeer
这个方式会从源码编译,第一次稍微慢点,但后续更新也方便。
基础使用教程
装好之后,第一件事是更新缓存。tealdeer 默认会从 tldr 的官方仓库拉取命令页面,所以需要先执行:
tldr --update
这个命令会下载所有命令的缓存到本地,之后查询就完全是离线状态,快得飞起。
查询命令用法
最常用的就是直接 tldr <命令名>:
tldr tar
你会看到类似这样的输出(有颜色高亮,这里用文字示意):
tar
归档实用工具,支持 tar、gzip、bzip2 等多种格式。
更多信息:https://www.gnu.org/software/tar/manual/tar.html。
- 创建一个归档文件:
tar cf 目标.tar 文件1 文件2 ...
- 解压一个 gzip 压缩的归档:
tar xzf 源.tar.gz
- 列出归档内容:
tar tf 源.tar
每个命令的页面都包含几个典型场景,每个场景一行示例,注释清晰。比 man 手册不知道高到哪里去了。
搜索命令
如果你只记得命令名字的一部分,可以用 --search:
tldr --search zip
它会返回所有包含 "zip" 的命令,比如 zip、unzip、gzip 等。
查看所有命令列表
tldr --list
会列出当前缓存里所有可用的命令,数量取决于你之前更新的缓存版本,一般有几百个。
进阶技巧
1. 自定义缓存目录
默认缓存放在 ~/.cache/tealdeer 或 ~/.local/share/tealdeer,但你可以通过环境变量 TEALDEER_CACHE_DIR 修改:
export TEALDEER_CACHE_DIR="$HOME/.config/tealdeer/cache"
如果你想把缓存和配置统一管理,这个很实用。
2. 使用自定义页面源
tealdeer 默认从 tldr 官方仓库(GitHub 上的 tldr-pages)拉取数据。但如果你公司内部有自己的命令文档库,可以配置自定义源。编辑配置文件 ~/.config/tealdeer/config.toml(如果不存在就创建):
[display]
compact = false # 默认 compact 模式,设为 false 会显示更详细的描述
[updates]
auto_update = true # 查询时自动检查更新(默认 false,建议保持 false 手动更新)
3. 颜色主题与输出格式
tealdeer 支持 16 色和 256 色终端。如果你觉得默认颜色不好看,可以通过 --color 参数临时调整,或者设置环境变量:
export TLDR_COLOR=always # always / auto / never
另外,如果你想输出纯文本(比如管道给 grep 或写入文件),加 --raw 参数:
tldr --raw tar | grep -i "gzip"
4. 结合 fzf 实现交互式查询
如果你经常记不清命令名字,可以把 tealdeer 和 fzf 结合起来,做成一个交互式命令浏览器:
tldr --list | fzf --preview 'tldr {}' --preview-window=right:70%
这样你会看到一个命令列表,选中后右边实时显示内容,非常爽。可以把这个 alias 加到 shell 配置里:
alias tldrf='tldr --list | fzf --preview "tldr {}" --preview-window=right:70%'
5. 在脚本中使用
tealdeer 支持 JSON 输出(通过 --json 参数),可以方便地被其他脚本解析:
tldr --json tar
输出是一个 JSON 数组,包含命令名称、描述、示例列表等字段,适合你用它来自动生成文档或集成到其他工具。
6. 离线模式
一旦你执行过 tldr --update,之后所有查询都是离线完成的。所以如果你在无网络环境(比如飞机上、内网服务器),只要提前更新过缓存,就能正常使用。这也是 tealdeer 相比在线文档的一个巨大优势。
一点个人感受
我用了 tealdeer 快两年了,从最初的好奇到现在的依赖,它已经成为我终端工具箱里不可或缺的一员。相比 man 手册的冗长,tldr 的示例驱动方式更符合现代开发者的习惯——我们不需要知道每个参数的哲学意义,只需要知道怎么用它完成工作。
而 tealdeer 作为 tldr 的 Rust 实现,把“快”这个体验做到了极致。每次 tldr curl 瞬间弹出示例,那种丝滑感,比打开浏览器搜索“curl 用法”快了不止一个数量级。
如果你还没试过,强烈建议装一个。哪怕你已经是 man 手册的忠实读者,偶尔换个口味,体验一下“秒查命令”的快感,也挺好的。