思源数据库共有如下 7 张表(以及两张虚拟表 **blocks_fts**与 **blocks_fts_case_insensitive**)

  • 在搜索框中与嵌入块中使用 SQL 查询仅能渲染 **blocks**表中的内容, 但是可以使用其他表进行辅助查询.
  • 集市中的挂件 Query 可以查询所有表中的内容.

    assets | 资源引用

    | 字段名 | 字段值示例 | 说明 | | —- | —- | —- | | id | 20211127144458-uinrvpj | 引用 ID | | block_id | 20210512171633-u3iy2xx | 块 ID | | root_id | 20200915214115-42b8zma | 文档 ID | | box | 20210808180117-czj9bvb | 笔记本 ID | | docpath | /20200812220555-lj3enxa/20210808180321-hbvl5c2/20200915214115-42b8zma.sy | 文档路径 | | path | assets/siyuan-128-20210604092205-djd749a.png | 资源文件路径 | | name | siyuan-128-20210604092205-djd749a.png | 资源文件名 | | title | 源于思考，饮水思源 | 资源标题 | | hash | 788c154262194a126b433b1055fbddcf5ada066e0d1f565a54e5550125675075 | 资源哈希值 |

attributes | 属性

字段名 字段值示例 说明
id 20211127144458-h7y55zu 属性 ID

| | name | bookmark | 属性名称

| | value | ✨ | 属性值 | | type | b | 类型

| | block_id | 20210428212840-859h45j | 块 ID | | root_id | 20200812220555-lj3enxa | 文档 ID | | box | 20210808180117-czj9bvb | 笔记本 ID | | path | /20200812220555-lj3enxa.sy | 文档文件路径 |

  • name 字段值
    • bookmark: 书签
    • name: 命名
    • alias: 别名
    • memo: 备注
    • fold: 折叠
    • heading-fold: 标题折叠
    • style: 样式
    • custom-XXX: 自定义属性
  • type 字段值
    • b: 块属性
    • s: 样式属性

blocks | 内容块

  • 该表还有两张全文本搜索(FTS)虚拟表, 用于更高效地全文搜索, 字段名称一致
    • blocks_fts: 英文字母大小写敏感
    • blocks_fts_case_insensitive: 英文字母大小写不敏感 | 字段名 | 字段值示例 | 说明 | | —- | —- | —- | | id | 20210104091228-d0rzbmm | 内容块 ID | | parent_id | 20200825162036-4dx365o | 双亲块 ID
      如果内容块是文档块则该字段为空 | | root_id | 20200825162036-4dx365o | 文档块 ID | | hash | a75d25c | content 字段的 SHA256 校验和 | | box | 20210808180117-czj9bvb | 笔记本 ID | | path | /20200812220555-lj3enxa/20210808180320-abz7w6k/20200825162036-4dx365o.sy | 内容块所在文档路径 | | hpath | /0 请从这里开始/编辑器/排版元素 | 人类可读的内容块所在文档路径 | | name | 一级标题命名 | 内容块名称 | | alias | 一级标题别名 | 内容块别名 | | memo | 一级标题备注 | 内容块备注 | | tag
      (v2.0.4 新增) | #标签1 #标签2# #标签3# | 非文档块为块内包含的标签
      文档块为文档的标签 | | content | 一级标题 | 去除了 Markdown 标记符的文本 | | fcontent
      (v1.9.9 新增) | 第一个子块 | 存储容器块第一个子块的内容(1.9.9 添加) | | markdown | # 一级标题 | 包含完整 Markdown 标记符的文本 | | length | 6 | markdown 字段文本长度 | | type | h | 内容块类型，参考⸢类型字段⸥ | | subtype | h1 | 内容块子类型，参考⸢子类型字段⸥ | | ial | {: id="20210104091228-d0rzbmm" updated="20210604222535"} | 内联属性列表，形如 {: name="value"} | | sort | 5 | 排序权重
      数值越小排序越靠前 | | created | 20210104091228 | 创建时间 | | updated | 20210604222535 | 更新时间 |
  • type 字段值
    • d: 文档块（仅在文档名上搜索，不会搜索文档包含内容块）
    • h: 标题块（仅在标题名上搜索，不会搜索标题块下方内容块）
    • l: 列表块（包含有序列表块、无序列表块和任务列表块）
    • i: 列表项块
    • c: 代码块
    • m: 数学公式块
    • t: 表格块
    • b: 引述块
    • s: 超级块
    • p: 段落块
    • tb: 分隔线
    • html: HTML 块
    • video: 视频块
    • audio: 音频块
    • widget: 挂件块
    • iframe: iframe
    • query_embed: 嵌入块
  • subtype 字段值
    • 列表块/列表项块子类型：
      • o：有序
      • u：无序
      • t：任务
    • 标题块子类型：
      • h1：一级
      • h2：二级
      • h3：三级
      • h4：四级
      • h5：五级
      • h6：六级

file_annotation_refs | 文件(PDF)注释引用

字段名 字段值示例 说明
id 20220110165814-wgit0t4 引用 ID
file_path assets/vim-reference-2.3.0 - Wei Zhi-20211230002422-9gbzdu0.pdf 关联文件路径
annotation_id 20220110165331-699dvqv 被引用注释 ID
block_id 20220110165327-kfadm4z 引用所在内容块 ID
root_id 20211230002404-5spavgt 引用所在文档块 ID
box 20210914201520-i0v92g9 引用所在笔记本 ID
path /20211230002404-5spavgt.sy 引用所在文档块路径
content Vim 中文手册 引用锚文本
type 注释类型

refs | 块引用

字段名 字段值示例 说明
id 20211127144458-idb32wk 引用 ID
def_block_id 20200925095848-aon4lem 被引用块的块 ID
def_block_parent_id 20200905090211-2vixtlf 被引用块的双亲节点的块 ID
def_block_root_id 20200905090211-2vixtlf 被引用块所在文档的 ID
def_block_path /20200812220555-lj3enxa/20210808180320-fqgskfj/20200905090211-2vixtlf.sy 被引用块所在文档的路径
block_id 20210104090624-c5bu25o 引用所在内容块 ID
root_id 20200905090211-2vixtlf 引用所在文档块 ID
box 20210808180117-czj9bvb 引用所在笔记本 ID
path /20200812220555-lj3enxa/20210808180320-fqgskfj/20200905090211-2vixtlf.sy 引用所在文档块路径
content 元类型 引用锚文本
markdown ((20200925095848-aon4lem "元类型")) 包含完整 Markdown 标记符的文本
type ref_id 引用类型

spans | 行内元素

字段名 字段值示例 说明
id 20211127144458-rwt8qka 行内元素 ID
block_id 20210429172522-ceauu94 元素所在内容块 ID
root_id 20200812220555-lj3enxa 元素所在文档块 ID
box 20210808180117-czj9bvb 元素所在笔记本 ID
path /20200812220555-lj3enxa.sy 元素所在文档块路径
content 请勿在帮助指南中保存数据 元素内容
markdown **请勿在帮助指南中保存数据** 包含完整 Markdown 标记符的元素内容
type strong 元素类型
ial {: style="background-image: linear-gradient(to right, var(--b3-theme-primary), var(--b3-theme-error)); -webkit-background-clip: text; color: transparent;"} 元素样式

行内元素类型

type 字段值 markdown 字段值示例 说明
code_span ’ 行内代码
em *开源软件* 斜体
inline_math $\\overset{\\text{shang}}{上}$ 行内公式
kbd <kbd>fn</kbd> 按键样式
link_text [Mermaid](https://github.com/mermaid-js/mermaid) 链接
v0.1.9及以前版本该类型markdown 字段与 content 字段完全相同, 均为链接的锚文本
mark ==0000000000== 高亮
strikethrough ~~0000000000~~ 删除线
stong **专业软件** 粗体
sub ~b~ 下标
sup(1.9.3 版本以前同为 sub) ^A^ 上标
underline <u>注1</u> 下划线
tag #思源笔记# 标签

stat | 其他信息

key value 说明
siyuan_database_ver 20211022 数据库版本
20211127144654-wd72ryx_hash 499ec649a66ffb730a90a8a54f8cb266436cea568ff4e4ad9698e0c537f24170 ID 为 20211127144654-wd72ryx 的笔记本的哈希