- 文档
【免费下载链接】OB_Template
OB_Templates is a Obsidian reference for note templates focused on new users of the application using only core plugins.
本篇文章以 OB_Template 开源仓库中的 联系人模板 为核心,完整拆解其 Frontmatter 元数据、联系信息字段与时间线日志三大结构,并给出从导入、配置到日常使用的完整实战流程。读完本文,你将掌握如何在不依赖任何第三方插件的前提下,用 Obsidian 原生能力搭建一套可检索、可链接、可长期积累的个人人脉档案系统。
一、模板全景:一个纯核心插件驱动的联系人笔记
OB_Template 是一个面向 Obsidian 新手的模板仓库,其核心约束在 README.md 的项目描述中写得很明确:所有模板必须只使用 Obsidian 的核心插件(core plugins),即便 DataView 等插件已成为很多用户的必需品,作者也刻意把模板保持得足够基础,以免吓到新手。
联系人模板正是这一理念的典型代表。整个文件只有三个部分,结构清晰到一眼就能看懂:
- YAML Frontmatter:定义别名(aliases)、创建时间(created)与标签(tags);
- Contact Info 区块:8 个联系人字段,覆盖联系方式的全部基础信息;
- Log 区块:一条带日期标题的空日志条目,作为时间线档案的起点。
模板文件位于仓库的 0A_Templates/0A_12_Contact/0A_12_Contact.md,在仓库的 模板总索引 中被描述为 "Template for a contact creation"(联系人创建模板)。它不属于某个具体人物,而是每次要记录一个人时,基于它新建一张笔记的骨架。
二、逐行拆解 Frontmatter:元数据如何驱动检索
模板开头是一段 YAML Frontmatter,它在 Obsidian 中承担属性(Properties)管理的职责:
--- aliases: ["first_name"] created: ["{{date}} {{time}}"] tags: - Contact/ ---2.1aliases:让笔记可以被多个名字找到
aliases: ["first_name"]定义了笔记的别名。别名的价值在于:当你在 Vault 中输入[[first_name]]或搜索 "first_name" 时,Obsidian 也能找到并链接到这张笔记,即使笔记的正式标题是另一个名字。
在实际使用中,这里建议替换为被记录者的名字或昵称。例如记录一位叫 "Zektor" 的联系人,可以把别名写成["Zektor", "Zek"],这样无论用全名还是昵称,都能在双向链接和全局搜索中命中同一张卡片。
2.2created:利用核心 Templates 插件的日期占位符
created: ["{{date}} {{time}}"]中的{{date}}与{{time}}是 Obsidian核心 Templates 插件支持的占位符。使用"插入模板"命令时,这两个占位符会被自动替换为当前日期和时间,从而在笔记创建的一瞬间就留下时间戳。
{{date}}:输出日期,默认格式如2026-10-14;{{time}}:输出时间,默认格式如18:48。
如果你希望日期输出为DD-MM-YYYY样式,可以写成{{date: DD-MM-YYYY}}——仓库中其他模板(如 公司模板 的created::. {{date: DD-MM-YYYY}} {{time}})正是这样做的,两种写法可以按个人偏好混用。
2.3tags:用嵌套标签归类
tags: - Contact/使用带斜杠的嵌套标签。Obsidian 会把Contact/视为父标签Contact下的一个子标签,便于在标签面板中按层级聚合所有联系人笔记。按照 README.md 中 FAQ 的说明,模板中的标签只是示例,你可以随意增删或改写,比如拆成People/Work、People/Friends来区分同事与朋友。
三、Contact Info 区块:8 个字段的含义与填写建议
模板正文的第一个区块如下:
# {{title}} ## 👨💼 - Contact Info Full Name:: Email:: Company:: Phone:: Address:: Linked Files::# {{title}}同样是 Templates 插件占位符,插入模板时 Obsidian 会用它替换成你在"插入模板"对话框中输入的笔记标题(通常是人名)。下方 6 个字段均采用Field::形式,这是 Obsidian 的行内属性(Inline Properties)语法,字段名和值之间用双冒号分隔。
各字段的推荐用法:
| 字段 | 建议填写内容 | 备注 |
|---|---|---|
Full Name:: | 全名,如Zektor | 与# {{title}}保持一致或更完整 |
Email:: | 常用邮箱 | 可填写多个,用逗号分隔 |
Company:: | 所属公司 | 可在此处用[[链接到公司模板笔记 |
Phone:: | 电话或微信 | 按需补充国家区号 |
Address:: | 地址 | 用于线下会面或邮寄场景 |
Linked Files:: | 相关文件链接 | 用[[文件名]]链接名片扫描件、合同、聊天记录等笔记 |
其中Company::和Linked Files::是让联系人笔记"活起来"的关键。仓库配套的 公司模板(Company/标签)记录公司层面的信息,你完全可以在联系人的Company::字段写入[[公司名]]形成双向链接;Linked Files::则可以挂接 会议模板 生成的会议记录、应用模板 记录的协作工具等笔记。
四、Log 区块:把静态名片变成时间线档案
模板的第二大区块是日志区:
## Log - ### {{date}} {{time}} - Initial Creation notes_go_here这是整个模板最具"第二大脑"色彩的设计:联系人笔记不是一次填完就结束的静态名片,而是一条不断追加的互动时间线。
## Log下的-是一个空列表项,用于快速追加新的时间线条目;### {{date}} {{time}} - Initial Creation是模板预置的第一条日志,插入模板时会被替换成实际创建时间;notes_go_here是占位提示,提醒你在创建当天写下一句"为什么会认识这个人"或"第一次接触的背景"。
长期使用后,每次与联系人互动(见面、通电话、合作、收到邮件),都可以在 Log 区追加一条新的### 日期 - 事件标题,再附上要点。几个月后回看,这张笔记就从"一份联系方式"升级成了"一份人际关系档案",这也是 README.md 所说的"像园丁一样照料你的笔记,最终欣赏自己的知识图谱"。
五、实战:把模板接入你自己的 Vault
根据 README.md 的 Usage 与 FAQ 说明,接入方式如下。
5.1 方式一:整库复制(推荐新手)
下载并解压仓库后,把0A_Templates目录(或仅0A_12_Contact子目录)直接复制进你的 Vault。注意:OB_Template 不是 Vault 模板,而是一个模板文件夹,复制后即可按需取用。
5.2 方式二:Raw 模式复制单文件
在仓库页面打开 联系人模板,切换为Raw(原始)模式,将全文复制,然后在你的 Vault 中新建联系人/张三.md之类的文件并粘贴保存。
5.3 启用核心 Templates 插件并配置模板目录
要让{{date}}、{{time}}、{{title}}占位符真正生效,需要按 README 的 FAQ 建议启用 Obsidian 自带的 Templates 核心插件:
- 打开设置 → 第三方插件 → 核心插件,启用Templates;
- 在 Templates 插件设置中,将"模板文件夹位置"指向你存放模板的目录(如
0A_Templates/0A_12_Contact); - 新建联系人笔记时,输入标题(如人名),然后执行命令面板(
Ctrl/Cmd + P)中的"Templates: 插入模板",选择联系人模板。
插入后,# {{title}}会被替换为笔记标题,created与 Log 标题中的{{date}} {{time}}会被替换为当前时间,notes_go_here提示也提醒你立刻补上第一句背景记录。若对日期格式不满意,可在 Templates 插件设置中调整日期格式,或改用{{date: DD-MM-YYYY}}这种显式格式。
六、融入仓库体系:命名规范与全局索引
OB_Template 的所有模板遵循一套可读的编号体系,README 的 File Structure 一节给出了规则:
- 文件夹:
0表示根笔记文件夹,字母表示一级分支,单词表示信息类型,如0A_Templates即"根笔记 → 第一分支 → 模板类"; - 文件:文件名携带层级信息,如
0A_1_1_DailyLog,逐段对应"根 → 分支 → 子目录 → 文件序号 → 文件名"。
联系人模板位于0A_12_Contact目录,属于第 12 类"Contact"。仓库的 模板总索引 在1️⃣2️⃣ - Contact一节中记录了这个模板。这里有一个值得注意的细节:索引中引用的是[[0A_12_1_Contact]],而仓库中实际文件名为0A_12_Contact.md。因此当你把模板搬进自己的 Vault 时,务必以实际文件名为准来写[[链接,否则会出现断链——这也是把模板体系本地化时的常见坑。
更进一步的联动思路:联系人是人脉网络的节点,而仓库中的其他模板天然适合作为节点之间的"边"——公司模板 记录组织、会议模板 记录交互、应用模板 记录工具、词典模板 解释行业术语。把这些笔记通过[[双向链接互相串起来,Obsidian 的关系图谱视图就会呈现出一张真实的人脉网络。
七、进阶:从联系人卡片到可检索的人脉知识图谱
7.1 用别名与全局搜索提升召回率
在 Frontmatter 中维护好aliases,配合 Obsidian 的全局搜索与[[快速插入,你可以在任意笔记(会议记录、项目笔记、日志)中几秒钟内链回对应联系人。搜索时命中别名同样会被索引,这正是aliases存在的意义。
7.2 用 Index 模板统一聚合
仓库的 Index 模板(Frame/标签)提供了按主题组织链接列表的骨架:## 1️⃣ - Theme1下放文件链接与一句话描述。你可以仿照它新建一张人脉索引笔记,把联系人按同事 / 朋友 / 客户分组列出,让 Vault 多一个"通讯录首页"。
7.3 关于 DataView 的边界说明
README.md 明确提到,DataView 已成为很多用户的必需品,但模板本身刻意保持"只用核心插件"的最低门槛;FAQ 中也将 DataView、Advanced Tables 列为"假设你已安装"的可选插件,而非必需。因此联系人模板开箱即用,零插件依赖。如果你后续安装了 DataView,可以自行在副本上编写查询(例如按Company::分组列出全部联系人),但这属于个人扩展,模板本体并不包含这类代码——这也符合仓库"模板仅供参考、鼓励在此基础上自建"的定位。
八、常见问题与排查
Q1:插入模板后{{date}}没有被替换?A:说明核心 Templates 插件未启用,或模板文件没有放在插件设置中指定的"模板文件夹位置"下。请检查设置 → 核心插件 → Templates是否开启,并核对模板目录路径。
Q2:标签Contact/有必要保留吗?A:不必。README 的 FAQ 明确说明模板中的标签都是示例,可按需增删。例如改为People/Work可以更细粒度地聚合。
Q3:联系人很多,如何快速找到某个人的卡片?A:依靠 Frontmatter 的aliases+ 全局搜索即可。为每个联系人维护好常用名/昵称别名,搜索效率会明显提升。
Q4:为什么 Index 里的[[0A_12_1_Contact]]链接点不开?A:仓库 模板总索引 中的引用名与实际文件名0A_12_Contact.md不一致。复制到本地后请以实际文件名为准修正链接。
从一段不到 30 行的 Markdown 骨架出发,联系人模板背后其实是 OB_Template 一以贯之的设计哲学:克制、零插件、可扩展。把它接入 Vault、填好字段、养成追加 Log 的习惯,再用[[链接串起公司、会议、项目与术语笔记,你就拥有了一套完全由自己掌控、长期可积累的个人人脉知识库——而这套能力,仅凭 Obsidian 的核心插件即可获得。
- 文档
【免费下载链接】OB_Template
OB_Templates is a Obsidian reference for note templates focused on new users of the application using only core plugins.
相关推荐
OB_Template 菜谱笔记模板实战:用 Obsidian 核心插件搭建个人菜谱库
OB_Template 菜谱笔记模板实战:用 Obsidian 核心插件搭建个人菜谱库 本篇指南聚焦 OB_Template 仓库中位于 0A_Template
文档OB_Template 读书笔记模板 0A_6_1_Books 详解:用 Obsidian 核心插件构建个人阅读笔记系统
OB_Template 读书笔记模板 0A_6_1_Books 详解:用 Obsidian 核心插件构建个人阅读笔记系统 本文以 OB_Template 仓库中
文档Obsidian知识库模板:5个简单步骤打造高效个人知识管理系统
Obsidian知识库模板:5个简单步骤打造高效个人知识管理系统 想要建立高效的Obsidian个人知识管理,但不知从何开始?kepano obsidian模板
文档知识管理
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考