跳到主内容
简牍jiandu
登录

官方知识库

平台维护的内容,只读;不参与你的标签体系

  1. 1安装 CLI 并登录一条命令装好,浏览器点一下授权
  2. 2发布第一篇jdu push 之后它就在你的列表里
  3. 3分享给别人私有 / 公开 / 官方三档,改档即时生效
  • 团队与指定读者谁能看见这篇文档 讲的是三档可见性。在此之上,private 文档还能按人放开:把特定的人加进读者池,或把文档放进团队。两者是并集:作者 ∪ 指定读者 ∪ 所选团队的成员都能读。
    协作教程
    只读09-15 · v1
  • Markdown 语法速查一页对照表:简牍支持的 Markdown 写法、几个扩展块,以及 Widget 的调用方式。想要更细的说明看 怎么写一篇文档。
    教程速查
    只读09-15 · v1
  • 在线示例:一篇简牍文档能长成什么样这一篇是公开演示,不需要登录就能看,也不依赖任何私有数据。它把简牍里最常用的排版与 交互组件放在同一页,让你在决定要不要装之前,先看清楚「写出来是什么样」。
    教程示例
    只读09-15 · v1
  • 模板:从已有文章提炼模板与方法论name: distill description: 把已经写过的同类文章反推成一份可复用模板 + 一份方法论。触发:提炼模板、生成模板、沉淀方法论、把这类文档变成模板、按标签生成模板、这类文章怎么写 arguments: topic(要提…
    template方法论
    只读09-15 · v1
  • 模板:技术方案name: tech-design description: 技术方案 / 设计文档:背景、目标与非目标、方案图、备选、风险、里程碑。触发:技术方案、设计文档、RFC -->
    template方案
    只读09-15 · v1
  • 模板:周报name: weekly description: 周报 / 本周进展同步。触发:周报、weekly、这周做了什么 -->
    template周报
    只读09-15 · v1
  • 用模板写文档模板就是一篇打了 template 标签的普通文档。周报该有哪几节、技术方案要不要写非目标、值班记录必填哪些字段——把骨架发成模板,之后每次(尤其是让 agent 写)都从它开始,同类文档结构才不会各写各的。
    写作教程
    只读09-15 · v1
  • jdu 命令速查配置在 ~/.config/jiandu/config.json(多站点共存:{ default, sites: { <别名>: {…} } }),可被 JIANDUSERVER / JIANDUTOKEN 覆盖。成功的 push 只在 s…
    教程速查
    只读09-15 · v1
  • 怎么读简牍站点发布之后的阅读、查找、主题、原文都在浏览器里完成。发布本身仍然只有 CLI 这一条路,站点上没有「新建文档」按钮。
    教程阅读
    只读09-15 · v1
  • 写一个自己的 Widget官方组件不够用时,自己做一个,推到站点,然后在 Markdown 里按名字调用。构建发生在你自己的机器上;站点只保存产物,不执行你的源码。
    教程组件
    只读09-15 · v1
  • 画流程图和差异对比流程图用 mermaid 代码块,差异用 diff 代码块。语言标识本身就会映射到对应组件,不必包 widget:。数据图表用 widget:Chart,见文末。
    写作教程
    只读09-15 · v1
  • 在文档里用 WidgetWidget 是 Markdown 里的组件:一个特殊代码块,语言写成 widget:名字,正文是 JSON。这篇是现成组件的用法,不是怎么自己写(那份见 写一个自己的 Widget)。
    教程组件
    只读09-15 · v1
  • 用标签整理文档标签是扁平的:一篇可以打多个,没有层级,没有强制词表。想做目录之前,先用标签把文档分成几堆。
    教程整理
    只读09-15 · v1
  • 谁能看见这篇文档可见性是文档的属性,跟「谁写的」分开。改可见性不必重新 push 正文。
    协作教程
    只读09-15 · v1
  • 发布、更新与版本一篇文档可以有很多个版本。jdu push 是发布;带 --id 是给同一篇追加新版本。
    发布教程
    只读09-15 · v1
  • 怎么写一篇文档简牍吃的是普通 Markdown。先按 GitHub 上那种 md 写,再按需加 Widget 和图表。
    写作教程
    只读09-15 · v1
  • 安装 CLI 并登录把 jdu 装到本机,并连上简牍站点。做完就可以 jdu push。
    入门教程
    只读09-15 · v1
  • 使用简牍本地写 Markdown,一条 jdu push 变成网页。这篇是使用教程的入口。
    入门教程
    只读09-15 · v1