笔记
0工具
0此页用于记录用户反馈问题后的每一次改进
关于
“写笔记”支持四种格式——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）。
这个网站最早只是一个人的笔记仓库，后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法，只是干干净净地存放一些东西；既然做好了，就公开出来，万一有人用得上呢。
不做大而全，不做平台梦，保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护：不会突然冒出付费墙，不会在角落塞广告位，也不会把你的数据卖给第三方。
产品会持续迭代，站内日志页记录着每一次改动，改了什么都有迹可循；想了解这个站是怎么一步步走到今天的，翻翻日志就能看到来龙去脉。
如果在这里看到涉嫌违规的内容，点对应卡片右侧的“举报”按钮就能提交，我们会尽快核实处理；也谢谢你花一点时间，一起把这里维护干净。
趋势
curl 发 POST 老报错，先分清表单、JSON 和 --data-urlencode
今天被同一个接口连续 400 了几次，排查下来发现是我把三种 POST 姿势搞混了。把 curl 调接口的几个坑整理一下，给经常写测试脚本的自己备忘。
先说最常见的误区：-d 传参数默认走的是表单编码，不是 JSON。我一开始写：
curl -sS -i -d 'name=zhang&age=20' api.example.com/v1/user
接口返回 400，提示请求体不是合法的 JSON。因为 -d 会自动带上 Content-Type: application/x-www-form-urlencoded，body 也是 key=value 那种表单串。接口端用 @RequestBody 那一套解析 JSON 的，收到这种就拒了。要给 JSON，得自己指定头、body 写成 JSON 字符串：
curl -sS -i \
-H "Content-Type: application/json" \
-d '{"name":"zhang","age":20}' \
api.example.com/v1/user
-d 后面跟一串 JSON 字符时，如果里面带了引号，外层最好用单引号包，避免 shell 把双引号吃掉或者把 $ 当成变量展开。想在命令行里内联写中文或者带嵌套结构的 JSON，单引号是底线，再复杂就建议把 body 写进文件：
curl -sS -i \
-H "Content-Type: application/json" \
--data @body.json \
api.example.com/v1/user
@ 前缀表示从文件读 body，文件名前加 @ 是 -d 系参数的通用法。这样中文、换行、特殊符号都老老实实待在文件里，不被 shell 搅和。
第二个坑是 --data-urlencode。表单场景里，如果值本身带了 &、=、空格、中文这种需要百分号编码的字符，直接 -d 会把 & 当成字段分隔符，把值拆了。比如搜关键词"a&b"：
curl -sS -d 'q=a&b' api.example.com/v1/search
服务端收到的会是两个字段 q=a 和裸的 b，语义全错。--data-urlencode 会先把值做百分号编码再拼进去：
curl -sS --data-urlencode 'q=a&b' api.example.com/v1/search
这样 q 的值就是完整的 a&b。我自己的经验是：只要值可能含特殊字符，一律用 --data-urlencode，别赌它恰好干净。
GET 请求带查询参数也是同款问题，配合 -G 用，curl 会把 --data-urlencode 的结果拼成 ?a=...&b=... 加到 URL 上：
curl -sS -G api.example.com/v1/search \
--data-urlencode 'q=虚拟环境 pip' \
--data-urlencode 'page=1'
不加 -G 的话 --data-urlencode 会发成 POST 的 body，加了 -G 才变成 URL 上的查询串。中文关键词走这个写法会被正确编码，服务端收到的 URL 是一串百分号，不会乱码。
第三个容易懵的是 -i 和 -v 的区别。-i 只把响应头打出来，后面跟响应体，适合快速看状态码和几个关键头；-v 是全程啰嗦模式，能看到请求发出去的完整样子，包括 TLS 握手、请求头、DNS 解析。排查"服务端到底收到什么"的时候，-v 比 -i 有用得多，因为能看到我上面说的 Content-Type 到底带没带对、URL 长什么样。嫌 -v 太吵可以看 -w 自定义输出：
curl -sS -o /dev/null -w "状态码:%{http_code} 耗时:%{time_total}s\n" api.example.com/v1/user
把响应体丢到 /dev/null，只打印状态码和总耗时，批量测接口存活很好使。
还有个细节是 -X POST 其实多数时候不用写。-d、--data、--data-urlencode 这些参数一旦出现，curl 会自动把请求方法切成 POST。写了 -X POST 反而可能带来副作用：比如配合 -G 用的时候，-X 会把方法锁死成 POST，把 -G 想要的 GET 顶掉。我见过有人调试半天，就是 -G 和 -X GET 一起写，curl 直接忽略 -G 的语义。想显式指定方法用 -X 没问题，但要知道它和 -G / -d 之间的优先级，别叠着写。
再补一个 --data-binary 的笔记，跟 --data 的区别是它不会去掉 body 里的换行和空白。--data 在读文件时会自作主张把回车换行清理掉，如果服务端对 body 的字节严格（比如签名校验按字节原样算），用 --data 传文件就会签名对不上。传原始字节用 --data-binary @file，这个我在调一个上传接口时卡了很久才想起来。以后再遇到 POST 不对，按顺序查三件事：Content-Type 带对没有、body 是表单还是 JSON、特殊字符编码了没有，基本能覆盖九成问题。