md.mszhou.com/p/mine
我的文档0 篇
团队与指定读者谁能看见这篇文档 讲的是三档可见性。在此之上，private 文档还能按人放开：把特定的人加进读者池，或把文档放进团队。两者是并集：作者 ∪ 指定读者 ∪ 所选团队的成员都能读。公开
Markdown 语法速查一页对照表：简牍支持的 Markdown 写法、几个扩展块，以及 Widget 的调用方式。想要更细的说明看 怎么写一篇文档。公开
在线示例：一篇简牍文档能长成什么样这一篇是公开演示，不需要登录就能看，也不依赖任何私有数据。它把简牍里最常用的排版与 交互组件放在同一页，让你在决定要不要装之前，先看清楚「写出来是什么样」。公开
模板：从已有文章提炼模板与方法论name: distill description: 把已经写过的同类文章反推成一份可复用模板 + 一份方法论。触发：提炼模板、生成模板、沉淀方法论、把这类文档变成模板、按标签生成模板、这类文章怎么写 arguments: topic（要提…公开
三行命令上线
# 安装 npm i -g @monoedge/jdu-cli # 绑定你的实例 jdu login --server https://md.mszhou.com # 发布 jdu push notes.md \ --visibility public \ --tag 架构
登录支持浏览器授权和 token 两种；没有站内编辑器，也不需要——你的编辑器已经够好了。
16个官方 Widget
3档可见性
∞成员数不限
1个 SQLite 文件
能力
发布、授权、渲染，三件事各解一次
一条命令上线
服务端在上传时就把 Markdown 渲染成 HTML 和压缩产物，浏览器拿到的是成品。图片和嵌套 Markdown 跟着文档一起走，不用手动传。
GFM 表格、脚注、代码 fence
稳定 block id，块链接不会失效
版本追加，旧版永远取得回
精确到人的可见性
私有 / 公开 / 官方三档，加上一个读者池。把人加进池子他就能读，撤销立刻失效——简牍不发「持有链接即凭证」的分享链接。
团队空间：成员可见、成员可发布
邀请制准入，受邀者绑 passkey
官方知识库是独立的只读区
文档能跑起来
Widget 用一行 widget: fence 调用，参数就是 JSON。mermaid 和 diff 直接走代码块语言标识，连 fence 名都不用改。
组件库可改 JSON 即时预览
Iframe / RawHtml 走沙箱
Mermaid 懒加载，不拖首屏
Widget
一行 fence，一个组件
技术文档里最需要的那些东西——流程图、差异对比、可勾选清单、选项卡——不该是截图。
AlertChartCollapseDiffGanttHighlightBlockIframeLinkCardsMermaidMindmapRawHtmlStatStepsTableTabsTodoList
widget:Mermaid懒加载
flowchart LR push[jdu push] --> check[校验] check --> render[渲染 + 缓存] check --> fail[退回并报错] render --> v[新版本 v+1]
widget:Diff语言标识直连
visibility: private | public
- official: boolean
+ visibility: private | public | official
archived: boolean
+ doc_readers(doc_id, reader)
widget:TodoList可勾选
official 改为 visibility 独立档位
读者池取代 link 档
迁移脚本幂等收敛
跨账户撤销闭环验证
widget:Alert / HighlightBlock四态
读者池不发链接撤销立刻失效。
邀请链接 7 天有效只显示一次。
删除连历史版本一起不可撤销。
选型
和另外两条路比，差在哪
简牍不适合所有人。如果你想要站内所见即所得编辑器，或者要给一万个人做公开站，这里都不是最优解。
| 简牍 | 托管笔记服务 | 静态站生成器 | |
|---|---|---|---|
| 数据在哪 | 你自己的机器，一个 SQLite 文件 | 对方的机器 | 仓库 + CDN |
| 发布方式 | 一条 jdu push | 站内编辑器 | commit → CI → 构建 → 部署 |
| 私有 + 定向可读 | 三档可见性 + 读者池，撤销即时 | 通常按套餐给 | 基本没有，要自己接鉴权 |
| 历史版本 | 追加式，每次 push 一版 | 有，通常按套餐留存 | git 里有，站上看不到 |
| 可交互组件 | 官方 Widget，JSON 传参 | 受限于平台自己的块 | 要写前端代码 |
| 站内编辑器 | 没有，也不打算做 | 这是它的强项 | 没有 |
定价
自部署永远免费
托管版帮你省掉一台机器和一次 Docker 部署，其余能力与自部署完全一致。
现在能用的是自部署：开源、全部功能、不限成员数。托管两档还在筹备，留个需求我们开放时按顺序通知。