first commit

This commit is contained in:
CrazyJasonwell
2026-07-23 20:36:13 +08:00
commit 513b68be8c
7915 changed files with 2642530 additions and 0 deletions
@@ -0,0 +1,169 @@
---
title: obsidian撰写草稿
date: 2022-03-21 18:39:22
status: complete
excerpt: 越来越进入正题了,从初学者的角度,尽可能克制地讲一点必要的东西,比如写一个草稿,标题段落列表插图超链接什么的,应该是足够了。
tags: []
rating: ⭐⭐
destination: 03-Projects/黑曜石玩家指南
share: false
created: 2025-08-30T11:45
updated: 2025-09-22T13:27
---
```ad-info
title: 友情提示
当您已经知晓如何使用格式化日志tracking事务之后,我强烈建议您从任一条 track 出发,创建相关的草稿以记录更多内容。此部分预估耗时15分钟。
```
### 从日志出发撰写草稿
当您在写日志时,有些事情一句话就讲完了,有些事情却难以在 Tracking 部分描述清楚。
![[列表缩进.gif]]
为了解决这个问题,您可以使用「列表缩进」,用来分条陈述更多细节。如上图所示,在某一行直接回车,然后按`Tab`键即可缩进。
如果内容实在太多,您希望用单独的一个页面来详细记录,那么可以直接输入两次 `` 即可自动转换为 `[[`,然后再输入新页面的名称并补全两个中括号,比如`[[这是一个新页面]]`, 这就创建了一个页面链接。您可以按住 Ctrl 点击该链接,直接按照设定好的[[草稿模板]]新建一个页面,并跳转到该草稿页面。
### front-matter
草稿是正在进行时,为了方便后续的一些信息聚合和自动化操作,所以 front-matter 内容稍多。草稿是根据[[草稿模板]]自动创建的,从[[草稿模板]]中可以看到 front-matter 的信息:
- title,标题,在创建草稿页面时根据文件名自动生成
- date,日期,自动填充的草稿创建日期。
- excerpt,摘要,一般是对草稿内容做一句话概括,可以完成后填写。
- tags,标签,多个标签用空格隔开。
- rating,评分,使用⭐表情
- status(草稿状态)默认为 inprogress,完成了请修改为 complete,草稿临时存放于 `/01-Diary/本周事务`
- destination,使用相对vault根目录的相对路径,比如该草稿属于项目A,你应当填写`/03-Projects/项目A`,后续可以使用 `quickAdd: 📒草稿归档` 命令对 `01-Diary/本周事务` 目录下的草稿实现**自动归档**。
- share (是否分享),所有草稿默认是不公开分享的,如果有需要手动修改为 true。
- obsidianUIMode,有 source 和 preview 两个选项,如果你希望此页面每次打开优先是预览模式,可修改为 preview。
在 front-matter 之后,草稿一片空白,可供您自由发挥。
```ad-tip
title: short link 使用方法
destination 的路径可以使用 short link,比如`03-Projects/01-项目名称` 可以基于**文件夹数字前缀**简写为 `03-01`,此时使用`quickAdd: 📒草稿归档` 命令,也能够实现正确的归档。因此你可以采取统一的`{数字前缀}-{文件夹名称}`的方式创建新文件夹。注意数字前缀不要超过2个字符,从00到99,以及0到9都是允许的。
```
### markdown基本语法
obsidian 编辑使用 markdown 语法,其实非常简单,通过一些符号标记就可以完成样式的声明,然后让浏览器按照主题样式渲染出漂亮美观的效果。
1. 首先是**标题**。在草稿中,我建议您使用「三级标题」作为每个小片段的标题,因为它的大小比较合适。而语法标记就是行首输入`###`,空格之后输入标题内容。
2. 然后是**段落**。obsidian中`换行再空一行`就会生成新的段落。一个段落只包含一个事情,一个说明即可。所以完全可以一句话就是一段,像写诗一样也是好的。电子笔记不费纸,多点空白不要紧。
3. 接着是**列表**。没有什么能比「分条缕析」更加清楚,所以尽可能地使用列表。如果是无序列表,行首使用`-`再空一格;如果是有序列表则是`1.`再空一格开始写。退出列表只需要回车两次即可。
4. 有时候要**强调**某些关键词,您可以先鼠标选中内容,然后按快捷键 `Ctrl+B` 就是**加粗**,按 `Ctrl+I` 就是*倾斜*,如果要`行内代码`就输入「\`」号。
5. 还有时候要**插入网络链接**,这个其实跟 word 文档中很像,选中要插入超链接的内容,按快捷键 Ctrl+K,然后会自动添加符号如`[您选中的内容]()`,光标会进入括号中,您直接粘贴url地址即可。
```ad-tip
title: 标题的作用
细心的你会发现,标题是可以折叠的。这一点当你的草稿很长的时候非常有用。写完一小节就可以折叠起来。
```
### 文本样式调整
本模板库在 ***v1.7*** 版本后可使用「增强编辑」插件实现对文本样式的调整。建议您先完成内容,再调整格式。此时可点击 obsidian 界面右下角的<span style="background:#97ca16">格式刷</span>,选择指定样式后去刷想要修改样式的文本,如H<sub>2</sub>O,调整结束后再点击格式化按钮即可取消格式刷。
### 插入图片
这里推荐配合 Snipaste 截屏工具使用(详见后续章节:[[Snipaste - 超好用的截图工具]]),当使用该工具截取屏幕之后,图片被复制到粘贴板,您只需要在草稿中按下` Ctrl+V` 即可完成图片的插入,obsidian 会将粘贴板中的图片拷贝到附件目录(`08-Assets`),并且自动生成指向该附件的链接,如下所示:
![[Pasted image 20220321194108.png]]
注意插入的图片`![[image.png]]`最好独占一行,而且前后均有空行。
#### 图片细节样式控制
本模板库使用的 [Blue Topaz 主题](https://github.com/cumany/Blue-topaz-examples)提供了丰富的对内容样式的调整方法。如果想控制图片的大小,可以是:
`![[img.png|300]]`
此时图片的宽度显示为 300 px。如果想插入 figure caption,建议如下操作:
`![[img.png#center|figure 1. 这是一张图表|500]]`
简单说明一下,图片文件名后面跟的 `#center` 指明了图片至于中间的位置,然后接下来 `|` 后面就是图注内容,再到后面则是指定显示宽度。
如果你想并排显示多张图片,可以像下面这样弄:
`![[img1.png|+grid]] ![[img2.png|+grid]]`
只要把图片后面跟一个 `+grid` 的说明即可。
```ad-warning
当你对图片的样式进行了调整之后,只能用 obsidian 自带的导出 pdf 才会维持这种样式。如果是通过自定义的方式 导出为 word 和 html,会出现报错。
```
### 插入表格
markdown 中输入表格一直都不大方便,不过在 obsidian 中情况还不是那么糟糕。具体而言,你只要会输入`|` 符号就可以了。
![[输入表格-1.gif]]
%%此处录屏转为gif使用的screen2gif工具%%
换行就 Enter,自动帮你创建与 column name 对齐的竖线,然后在后续行输入数据的时候,切换列只需要按 Tab 键就可以了。具体实现效果如下:
| a | b | c |
|:---:|:---:|:---:|
| 1 | 2 | 3 |
| 3 | 5 | 4 |
事实上得益于插件,你还可以直接在 obsidian 中对表格进行计算,下载表格中的数据另存为 csv文件。但是这里限于篇幅不做过多讲述,感兴趣的朋友可自行查看插件列表。
### 插入其它附件
除了可以在草稿中插入图片,您还可以插入视频,音频等多媒体文件。您可以通过快捷键 `Ctrl+E` 进行「全局预览」并播放。当然也可以按住 Ctrl 键,将鼠标悬停于这些附件链接上方实现「局部预览」。
《原神·晨曦酒庄-陈致逸》
![[陈致逸,HOYO-MiX - Dawn Winery Theme 晨曦酒庄.mp3]]
> 仅支持 mp3 音频文件在预览模式下播放
《原神·游戏片段截取》
![[PM.mp4]]
> 仅支持 mp4 格式视频文件在预览模式下播放
事实上,其它任何类型的文件都可以插入。而且方式非常简单,都是直接把文件拖入草稿编辑区域。然后附件都会保存到 `08-Assets` 附件目录中。如果您是从该附件目录中拖入的文件,则会自动复制一个附件副本,所以需要格外注意。
### 修改默认编辑模式
我习惯于传统的纯文本的编辑模式,这对于内容编辑有着精准的控制,而且不会因为实时渲染而产生比较大的计算开销,使用起来会很流畅。
但是在一些特殊场景中,比如[[../3-obsidian做课题/撰写论文草稿]]时,需要看着 figure 进行具体的描述,这个时候就需要实时预览了。
![[Pasted image 20220331162123.png]]
如上图所示,你可以随时修改**默认编辑模式**。
![[Pasted image 20220331162910.png]]
### 多使用分节小标题
当草稿内容比较多的时候,建议对于表达一个意思的段落内容直接使用分节小标题,这样有利于信息的快速提取,方便后期review时高效定位。而且本模板库继承了 Topaz 主题的 floating-toc 插件,在编辑模式下可以在页面左侧显示悬浮目录。
![[floating-toc.gif]]
### 完善front-matter
与日志类似(详见[[开箱写日志#完善日志信息]]),当您完成了草稿的主体内容之后,请完善 front-matter 中的信息。这个步骤略有繁琐,但是却是非常必要的步骤,因为这是第一次对最原始的文本草稿数据进行汇总整理,有利于后续自动化的信息聚合(参见[[每周定期汇总小结]])。
```ad-info
title: 下节预告
根据实际场景,大家不大可能一天二十四小时对着电脑工作。所以日志的撰写,还有移动端的需求。下一部分内容将介绍如何使用obsidian移动客户端辅助日志草稿。
```
---
page:: 4
@@ -0,0 +1,108 @@
---
title: zotero-obsidian联动配置
date: 2022-03-21 15:16:11
status: complete
excerpt: 果然完成这个内容又花费了一个小时,所以以后可以按照一小时一节的效率来安排时间。
tags: []
rating:
destination: 03-Projects/黑曜石玩家指南
created: 2025-08-30T11:45
updated: 2025-09-22T13:27
---
```ad-info
title: 友情提示
在[[软件下载安装]]完成后,我们需要完成一些配置以实现zotero和obsidian的联动,估计耗时10分钟。
```
### 模板库目录结构说明
- 00-MOC:内容地图,主要存放dataview查询表
- 01-Diary:存放模板化的每日日志,其中每周事务是看板笔记默认存放地
- 02-Reading:存放文献库和文献阅读笔记
- 03-Projects:按各种实际的项目分类存储相关笔记
- 06-Cards: 主要存放一些卡片
- 07-Archives:时间久远而且已经结束的project可以进行存档
- 08-Assets:存放附件,包括插图、视频、以及各种其它文件
- 09-Templates 存放笔记模板
### zotero 设置
![[Pasted image 20220322201722.png]]
打开 zotero 之后,点击菜单栏的 「编辑」,然后选择「首选项」,进入到 zotero 的设置当中。如上图所示,需要对箭头所示的地方做修改。
特别需要注意的是「高级」中的`链接附件根目录` 和 `数据存储位置` 的路径设置。前者必须是 vault 库中存放 pdf 的子目录。
本教程 vault 根目录为 `X:\projects\working`,而`\08-Assets\pdfs`是存在于该 vault 中的子目录,专门保存文献条目的 pdf 附件。设置正确的路径后我们在选择使用`相对路径`,这对于后面调用 zotfile 插件很关键。
数据存储位置您可以选择默认(如果C盘够大)或者指定一个其它不在 vault 中的目录。
### zotfile插件安装和设置
```ad-tip
如果你经常用iPad看文献,且有较强的多平台多设备云同步的需求,建议不要使用zotfile插件,这并不会影响本模板库的使用。
```
![[Pasted image 20220321154948.png]]
zotfile 是 zotero 中最强大的插件,点击 zotero 菜单栏的「工具」> 「插件」,可以进入插件管理器,然后点开齿轮,选择从文件安装插件。插件为`.xpi`后缀的文件,在[[软件下载安装]]中已经提及。后面的 mdnotes 和 better bibtex 插件的安装同此操作。
![[Pasted image 20220322201929.png]]
然后对 zotfile 插件进行设置。点击 zotero 菜单栏的「工具」就能看到 zotfile 的插件设置选项。如上图所示,对箭头所指内容进行修改。
注意**将 pdf下载的临时目录设置为桌面**,以后可以从网上直接下载 pdf 到桌面,再选择pdf对应的文献条目,右键单击后选择`Attach New File`,调用该插件可以自动把 pdf 重命名并转移到**指定目录**(`\08-Assets\pdf`)去,并且创建指向 pdf 的链接。
### mdnotes 插件安装与设置
![[Pasted image 20220322202038.png]]
同 zotfile 的安装方式,其设置选项也在zotero 菜单栏的「工具」中可见,点开后如上图所示做修改,尤其要注意路径的设置。注意 mdnotes 导出目录为 `02-Reading/mdnotes`,而 mdnotes 的模板存放于 `08-Assets/Scripts` 中。
### better bibtex 插件安装与设置
![[Pasted image 20220321155719.png]]
插件安装同 zotfile,但是其设置选项已经被整合到 zotero 首选项中了(说明是个更加高级的大插件)。在这个地方,我们需要修改 citation key 的格式,如上图所示:就作者加年份即可。
此外,还需要修改 Export > Quick-Copy 中的格式为 Roam Cite Key。这样当你使用快捷键 `Ctrl+Shift+C` 从 zotero 中拷贝文献,就会拷贝一个 Roam Cite Key 格式的内容出来。
![[Pasted image 20220321160208.png]]
然后再到「导出」选项中修改 zotero 的便捷复制,选择 Better BibTex Quick Copy: Roam Cite Key,就大功告成了。
如某篇文献的 citation key 是 `xxd2022`,那么对应的 Roam Cite Key 就是 `[[@xxd2022]]`,然后你把这个 Roam Cite Key 直接粘贴到 obsidian 中就完成了引文的插入,非常便捷。
### 导出「我的文库」到 Vault
![[Pasted image 20220321161118.png]]
如上图所示,在完成了上述提及的三个插件的设置之后,我们可以右键点击「我的文库」,然后选择「导出文献库」,并且选择 Better BibLaTeX 的格式并 Keep updated。导出到 **指定目录**`\08-Assets\Scripts`)去,注意文件名修改为英文`MyLibrary`。
### bib文件检查
完成了上述配置和操作后,请注意检查,在目录`X:\projects\working\08-Assets\Scripts`下应当存在以下文件:
- **MyLibrary.bib**:与 zotero 文献库同步的 bib 文件,由 better bibtex 插件导出并维持更新
- acs-nano.csl:引文格式文件,用于生成 acs nano style 的 bibliography
- markdown.csshtml样式文件,用于将笔记导出为 html
- Mdnotes Default Template.mdmdnotes笔记模板文件
- template.docx:用于将笔记导出word文档的模板
- paper2docx.py:导出笔记为docx和html 的python代码
### 关于坚果云同步的说明
此模板库由于本人从不用iPad看文献做笔记的原因,zotero 的附件使用 zotfile 存储于 `08-Assets/pdfs` 目录中,暂时无法使用坚果云 WebDAV 服务实现zotero iPad 和 Desktop 的同步。如果你基本是使用 Zotero iPad 看文献,并且使用坚果云进行同步pdf附件。**不要使用 zotfile 插件即可**。
```ad-info
title: 下节预告
到这里,基本上所有的安装和配置已经弄完了,接下来我们就可以愉快地开始使用 obsidian 了。详见下一节[[开箱写日志]]。
```
---
page:: 2
@@ -0,0 +1,71 @@
---
title: 使用手机撰写日志
date: 2022-03-22 08:13:34
status: complete
excerpt: 这个部分只是作为补充,但又有必要说,因为移动输入也是刚需。
tags: []
rating: ⭐⭐
destination: 03-Projects/黑曜石玩家指南
share: false
created: 2025-08-30T11:45
updated: 2025-09-22T13:27
---
```ad-info
title: 友情提示
obsidian 同时有 Android 和 iOS 版本的 app。所以如果电脑不在身边,您完全可以使用手机撰写日志。此部分内容预估10分钟。
```
### 下载安装移动版obsidian
苹果的应用商店可以直接搜索到 obsidian,可以直接安装。对于普通安卓手机用户,或许也可以从应用商店下载,但是我使用的华为手机鸿蒙系统的应用商店没有,所以自己在网上找的 apk 手动安装。
- 安卓版obsidianAPP:可到[obsidian移动端模板库Release](https://github.com/sheldonxxd/obsidian_mobile_vault_template/releases/tag/v1.0)中下载。
### 下载移动版obsidian模板库
由于手机app与部分插件不兼容,而且手机app中一般仅作为随手日志的用途,所以在此教程前面所提及的模板库上进行了精简,仅保留了您已经掌握的「写日志」和「写草稿」的工作流程。您可以在 Release 页面中搜索「mobile_vault_template」找到压缩包下载解压即可。如果您查看的是本教程的草稿版本,那么下方的文件链接是有效的:
- [obsidian移动端轻量模板库](https://github.com/sheldonxxd/obsidian_mobile_vault_template)
因为有着相同的「写日志」工作流程,使用此页体积的轻量级模板库之后,能够与电脑上的 vault 库在操作上和内容格式上尽可能保持一致。
### USB连接手机并传输文件
![[Pasted image 20220322084040.png]]
手机安装好 obsidian 之后,您可以把「**轻量模板库**」中的内容复制到手机内部存储中,比如我放在 `/Documents` 目录中并重命名为 sheldon。
### 打开Vault并完成初始化设置
打开手机上的 obsidian,第一次使用需要一些同意协议和权限,修改界面语言。同样地需要关闭安全模式以启用第三方插件。
![[Pasted image 20220322094808.png]]
如上图左所示,为了丝滑地**使用 quickAdd 命令(在任意区域下拉即可唤起)**,您还需要设置快捷命令。手机操作界面仍然分为三个部分,虽然竖屏只能显示一部分,但是左右滑动可以切换。
### 手机客户端的内容编辑
与之前介绍的「写日志」流程一样,您可以使用 QuickAdd 中的 Tracking 命令快速记录下闪念笔记。也可以从日志中创建其它草稿。
与电脑客户端不同,手机客户端提供了快捷输入栏,方便您创建双链、插入图片以及设置文本样式等等。另外您也可以通过手机输入法提供的「语音转文字」输入功能快速写入文本。
### 手机内容同步至电脑
obsidian 移动客户端仍然把所有资料存储于手机本地,而云同步是付费服务。但是考虑到桌面客户端使用的完整模板库内容更加庞大复杂,我并不推荐您使用云同步的方式解决此问题。
正确的做法是手动定期同步。我建议您只把 obsidian 作为补充性质的临时记录工具,仅在不得不需要记录而电脑不在身边的情况下使用。
我个人的做法是,一般当天写 excerpt 摘要之前,就会直接把手机日志或草稿中的内容复制粘贴,通过微信发送到电脑,然后粘贴到桌面 vault 库中。
有些童鞋可能会采取 split 的方案,日志什么的统一放到手机上写,而其它部分放到电脑中。这种方案我也曾尝试过一段时间,感觉非常割裂。它使得「一切从日志出发」的理念无法丝滑地实现。所以我也不建议。
```ad-info
title: 下节预告
当日志和草稿积累起来之后,我强烈建议您每周定期整理小结一次。所以这就是我们下一章节的主要内容了。
```
---
page:: 5
@@ -0,0 +1,149 @@
---
title: 在obsidian中写幻灯片
date: 2022-03-22 12:27:26
excerpt: 这篇就直接就按照幻灯片的方式来写吧
tags:
- ppt
rating: ⭐⭐⭐
status: complete
destination: 03-Projects/黑曜石玩家指南
share: false
created: 2025-08-30T11:45
updated: 2025-09-22T13:27
---
%%这就是第一张封面,不需要多么花里胡哨,title、author、date信息有了就够了%%
### 在obsidian中写幻灯片
sheldonxxd
2022年3月22日
---
### 简洁明了最重要
![[Pasted image 20220322124645.png]]
一张 slide 一张图,一句话足矣。
---
### 幻灯片规则
- 使用三级标题
- 每张幻灯片用 `---` 隔开
- 就这么简单。
---
### 幻灯片预览
![[Pasted image 20220322125059.png|600]]
按快捷键`Ctrl+Shift+E` 可以调用插件开启预览。
---
### 调整插图大小
![[Pasted image 20220322125339.png]]
上一页slide的插图就有点大
可以在插图链接后添加`|width`实现。
---
### 字体高亮
![[Pasted image 20220322125620.png]]
有时候需要对关键词做高亮处理。
「ZH编辑增强插件」提供了快捷键。
选中文本按 <span style="background-color:#ff0000">Ctrl+Alt+数字</span> 即可。
---
### 在浏览器中查看
![[Pasted image 20220322125725.png]]
幻灯片预览面板可以选择在浏览器中打开。
---
### 切换幻灯片
![[幻灯片播放.gif]]
键盘上的方向键就可以实现幻灯片的切换。
---
### 幻灯片播放的其它快捷键
- `F`focus,全屏展示
- `C`:打开画笔,可以标注
- `D`:可以下载画笔标记数据
- `S`Speaker,演讲者模式
- `V`:暂停播放
- `M`Menu
- `O`Overview
- `Alt+Click`:放大
---
### 导出独立幻灯片文件
![[Pasted image 20220322130547.png]]
如上图所示,操作步骤如下:
```
1. 点击幻灯片预览面板的选项
2. 点击 Export as html后关闭预览,切换到幻灯片编辑草稿面板
3. 可以看到在 vault 根目录生成了一个 folder
4. 运行 QuickAdd: PPT导出 命令
5. 在桌面的 obsidian-slides 目录中可以看到被导出的html
6. 您可以把整个 obsidian-slides 文件夹拷贝到U盘
7. 然后到其它设备使用网络浏览器播放
```
---
### 导出为pdf
![[Pasted image 20220324150712.png|500]]
同上张片子,但选择 <span style="background-color:#ff0000">Print Presentation</span>
会自动跳转到浏览器去打印,注意配置,打印到桌面即可。
---
### obsidian幻灯片的优势
1. 幻灯片仍然是文本,易于内容搜索和管理
2. 减少使用其它软件按编辑体验的割裂感
3. 导出独立HTML只要有浏览器就能播放
4. 专注于内容,无需担心排版错误
5. 有助于养成简洁风格「一图一句一张片」
6. 轻松撰写公式,如 $y = x_{1}\times\frac{\pi}{\lambda}$
---
### 重要提醒
此类幻灯片仅作为草稿和非正式场合使用,
如果需在比较重要的场合展示,建议使用`quickAdd:👑导出笔记`将草稿和相关素材导出后,
在 Powerpoint 或 Keynote 此类软件中进一步编辑。
---
page:: 7
@@ -0,0 +1,93 @@
---
title: 开箱写日志
date: 2022-03-21 16:45:19
status: complete
excerpt: 写日志可以非常简单,就是一个按键的事情。
tags: []
rating: ⭐⭐
destination: 03-Projects/黑曜石玩家指南
share: false
created: 2025-08-30T11:45
updated: 2025-09-22T13:27
---
```ad-info
title: 友情提示
在安装配置完成后,您可以打开模板库开始撰写第一批日志了。
```
### 用obsidian打开模板库
当你第一次打开 obsidian,务必打开自己已经解压并重命名好的模板库,如`X:\projects\working`
![[Pasted image 20220321164743.png]]
就这一次,obsidian 会记录位置。下次就会自动打开这个库。
### 关闭安全模式
![[Pasted image 20220321165012.png]]
如果你是第一次打开带有大量第三方插件的模板库,obsidian 会弹出提示,询问你是否要关闭安全模式,请务必关闭,否则插件不能使用。
### 修改界面语言
![[Pasted image 20220321165131.png]]
第一次使用 obsidian 默认界面是英语,你可以在首选项(左侧边栏最底下的小齿轮``)中,进入到关于`About` 进行修改,如上图所示。我相信由于我使用中文撰写的教程,应该用户估计以汉语为母语的为多数,改过来还是方便一点。
### 用户界面概览
![[Pasted image 20220331150701.png]]
然后你会看到如上图所示的总体软件界面,看上去有点复杂,很多按钮面板什么的。我们暂时都不用理会,这里只是放上来让大家有个整体印象。
### 创建日记
![[Pasted image 20220321165826.png]]
一个快捷键就够了,请按`Ctrl+Q`,它会唤起 QuickAdd 的下拉菜单面板。直接点击`⏱️随手记记`进行当天的日志记录。
![[Pasted image 20220321170113.png]]
此时会弹出一个多行输入的窗口,你可以写上一段话。作为某种闪念笔记。或者记录当下的任何内容。点击「OK」之后,日志流程被启动,今天的日志页面会被自动按照设定好的模板([[日志模板]])创建出来。而刚刚输入的内容会被添加到日志页面的 Tracking 部分。
![[Pasted image 20220321170310.png]]
你可以使用快捷键 `Alt+T` 跳转到今日的日志页面,也可以直接点击日历进入。可以看到,这种闪念记录,以时序列表的方式被记录下来,还带有时间戳。
### 日志结构介绍
日志页面结构上主要分为三大部分,从上到下分别是:
- front matter(前言):记录了这个日志的一些 meta-info,比如自动填充的日期(date),标签(tags),摘要(excerpt)以及评分(rating)。
- ![[Pasted image 20220321170925.png]]
- TODO:主要是今天要做的事情。将光标至于末尾直接回车会新建一个今天的小任务。如果任务已经完成,光标至于该任务item所在行,按快捷键 `Ctrl+Enter` 即可自动打`×`。
- ![[新建todo.gif]]
- Tracking:用于记录闪念笔记吧,随便写,按照时间顺序排列。
### 完善日志信息
在一天结束之前,我强烈建议您花五分钟回顾一下今日日志记载内容,并在 front-matter 中完善相关信息,比如标签(tags),摘要(excerpt)以及评分(rating)。这样做有利于后续的信息聚合整理流程(参见[[每周定期汇总小结]])。
### 把日志当朋友
当一天结束,您可以清楚地看到自己今天完成的事情以及分时记录的各种内容,看一看回顾一下,是否会产生某种充实感呢?
当然了,即便今天很多时候在摸鱼,在不受控制地放纵自我,只要你**如实地定时地记录**了下来,这种反思与回顾也能够帮助你尽快走出困境。
此外也要注意「过犹不及」的情况:如果你啰里啰唆整天正事不干,总是在日志里输入一些没有营养的内容,而不去解决真正实际的问题,日志如果会说话恐怕就要嘲笑你了。根据我的经验,**每天不超过10条 track ,每条 track 不超过 140字是比较合适的**(平均一小时一条)。
总之,您完全可以把这个 vault 当作是最值得信赖的朋友,请畅所欲言,不要有丝毫顾忌。因为所有的数据都存储于本地,您拥有对它的绝对控制权。
```ad-info
title: 下节预告
写日志就是这么简单,日积月累,积少成多,当日志变多了之后就可以写周小结。周小结再次进行汇总又可以是月总结。不过接下来,您需要掌握一些基础的markdown语法和编辑技巧,以便撰写出图文并茂的笔记。
```
---
page:: 3
@@ -0,0 +1,44 @@
---
title: 恭喜入门obsidian
date: 2022-03-22 14:39:04
excerpt: 一天时间写完第一章,主要还是靠整理之前的笔记吧。
tags: []
rating: ⭐⭐⭐
status: complete
destination: 03-Projects/黑曜石玩家指南
share: false
created: 2025-08-30T11:45
updated: 2025-09-22T13:27
---
从我昨天下午决定开始写一本关于 obsidian 使用的书,打算用三个月的时间。结果到今天中午就完成了第一章「obsidian入门」的主要内容,也就是一天的功夫。所以说很多事情真的是要趁热打铁才效率高。(写论文要是有这个效率早就起飞了😂)
这第一章本来按照我的规划,只有三部分内容:先谈谈**安装配置**,然后讲一下**写日志**,**读文献**。但实际写起来了,我基本才写完「写日志」这部分的内容,就已经用掉七节了。所以说大纲也不要太当真,更重要的是内容安排是否合乎实际。
没错,我基本是从初学者的角度,边用边写(所以<span style="background-color:yellow">读者请跟着一步步操作即可</span>)。要说比较繁琐的地方,就是这一套下来的各种安装配置。我估计一般对电脑不大了解的童鞋,在第一节第二节就会被一个接着一个的下载安装配置给劝退。
没办法,免费开源又好用(会才好用🙄)的软件工具最大的缺点就是不够傻瓜。而且在本教程中利用到的不仅仅是一个 obsidian,而是 obsidian + zotero + anaconda + pandoc 等一群开源软件和插件组成的工具链。(详见[[软件下载安装]])
![[Drawing 2022-03-23 08.45.37.excalidraw|600]]
这个工具链中任一单独的软件都无法提供独立而完整的高效方案,以解决科研工作者在学术研究活动中对电子资料进行统一便捷管理的需求。所以我以 obsidian 为核心,有机地整合这套工具链,服务于<span style="background-color:#66aabb">「写日志」和「读文献」两大基础工作流</span>。
工具链的整合是有相当高的门槛的,不仅需要你有丰富的计算机使用经验(包括编程),还需要对日常工作流程和信息管理有深入的理解。你可以理解为:原始的 obsidian 是一把用料扎实的粗胚大剑,而在本教程中经过工具链的加持,它或许已经开锋,成为一把解决科研工作者电子资料管理的利剑。
所以,请耐心和细心阅读,一步步地完成第一节([[软件下载安装]])和第二节内容([[zotero-obsidian联动配置]]),这个无聊、繁琐的阶段一旦迈过,接下来的内容将变得极其简单。
![[Drawing 2022-03-23 08.04.18.excalidraw]]
你将会看到,**写日志**([[开箱写日志]]))也就是一个按键的事情,你可以完全专注于内容,而无需理会日志的格式要求。你也会感受到以每日日志为核心出发**创建草稿**([[obsidian撰写草稿]])的流程便捷。至于**周小结**([[每周定期汇总小结]])、**幻灯片**([[在obsidian中写幻灯片]]),都是非常简单的事情。说白了,会打字就行。
另外,考虑到移动输入的刚需,我还准备了手机客户端obsidian如何使用的补充内容([[使用手机撰写日志]]),可以方便用户临时以及随时记录日志。当然了这里我再次建议,移动端obsidian仅仅是作为一种补充手段,主要还是以桌面客户端 obsidian 对个人 vault 库进行操作。
一章七节,再加上这段凑字数任意发挥的「本章小结」,我觉得字数篇幅上已然足够了。而且内容上也已经相对完整。当你会写日志、写草稿、写周小结和搞幻灯片之后,可以先坚持用它一两个星期,跟 obsidian 培养培养感情。再进入到下一个阶段。
拥有了第一章的写书经验,下一章我打算专注于介绍 obsidian 如何具体服务于科研活动。比如实验记录、文献阅读笔记、试剂清单管理甚至论文草稿撰写等等。相信了有了 obsidian 入门基础。进阶到具体业务层也会更加轻松。
对于非科研工作者,第二章或许对您仅有借鉴意义。您可以结合第三章(插件篇)和第四章(自定义代码)内容了解如何针对一个 specified 的 workflow 配置相关插件甚至自己写代码脚本实现所需功能。
---
page:: 8
@@ -0,0 +1,60 @@
---
title: 每周定期汇总小结
date: 2022-03-22 10:18:22
excerpt: 周小结可以说是写日志做笔记中最重要的一件事情了。
tags: []
rating: ⭐⭐⭐
status: complete
destination: 03-Projects/黑曜石玩家指南
share: false
created: 2025-08-30T11:45
updated: 2025-09-22T13:27
---
```ad-info
title: 友情提示
对于写日志做笔记这件事情,如果不定期整理,提取概括关键有效的信息,过了一周就会乱成一团。
```
### 本周事务表
![[Pasted image 20220322113006.png]]
您可能会注意到在 obsidian 左侧目录文档树中,`00-MOC`内存在一个 [[本周事务表]],里面仅仅填写了一些看不懂的代码,但是如果使用预览模式却能看到对本周创建的草稿内容的一个汇总。这样可以对本周做了哪些「大事」,还有哪些事情没有完成,能做到一目了然的效果。
如上图所示,由于草稿创建后自动在 `01-Diary/本周事务` 目录下生成文件,然后草稿的很多 front-matter 可以作为元数据被 dataview插件 抓取。这里我通过一个 query 提取了草稿的文件名、标签、摘要和最后修改日期。在预览模式下,当鼠标悬停于文件名时,还能够激活局部预览。
这里涉及到使用 dataview 插件对相关内容进行整合和显示。由于 dataview 插件使用较为复杂,我不推荐大家入门阶段就去了解和掌握。有基础的童鞋可以直接跳转后边的内容。
### 创建周小结
还记得我们「一切从日志出发」的宗旨吗?(参见[[obsidian撰写草稿#从日志出发撰写草稿]])
创建周小结同样是从某一天的日志出发。我个人喜欢在周五进行小结,因为周六要开组会,需要提前梳理一下各方各面的事情。大家可以根据自己的事情情况,固定一周的某一天用于创建周小结。
![[Pasted image 20220322114514.png]]
您可以在当天日志的某条 track 之后,按`Ctrl+Q`召唤 quickAdd 命令面板,并点击 `🐷每周小结`,就会在这条track之后插入周小结的链接,并自动按照[[每周小结]]模板创建新的页面,存放到 `01-Dairy/周小结` 目录中,最后帮你跳转到这个新建的周小结页面。
### 周小结内容结构说明
![[Pasted image 20220322115313.png]]
上图截取了[[每周小结]]模板内容。周小结分为五个部分:
- **front-matter**, 中的内容请在周小结完成后填写补充。(参考[[obsidian撰写草稿#front-matter]]
- **日志汇总**,是对最近一周日志内容的聚合展示,在预览模式下可查看信息表格。
- **本周完成事项汇总** 需要您对[[本周事务表]]中已完成部分表格进行截图并粘贴,然后在自此执行`QuickAdd: 📒草稿归档` 命令以自动归档。这个操作会清空`01-Dairy/本周事务`中状态为 complete 的草稿,并将它们按照草稿 front-matter中 `destination` 的值转移到指定目录。 ^0zs3cr
- **本周小结**, 可以从工作生活学习多个方面,分条概述情况。如果有小组会报告的需求,可以从此处创建一个新的草稿,就命名为`[[小组会-202203xx]]`,然后在新的草稿内以 markdown 的方式撰写幻灯片用于小组会展示(参见后续内容[[在obsidian中写幻灯片]])。
- **后续安排**,一个小结主要是回顾和展望,所以简单罗列下后面一周的安排吧。
周小结是对日志的总结,以此类推,[[每月总结]]是类似的操作,这里不再赘述,您只需要在 quickAdd 命令面板中找到 `🦁月度总结`,然后在约定好的每个月的某一天的日志 track 中插入即可。
```ad-info
title: 下节预告
自己每周的小结可能包含很多个人隐私的内容,而关于工作部分的周小结通常是需要分享汇报的。所以我们有着做幻灯片展示的刚需。下一个部分的内容就详细介绍如何制作 obsidian 幻灯片。
```
---
page:: 6
@@ -0,0 +1,106 @@
---
title: 软件下载安装
date: 2022-03-21 14:13:40
status: complete
excerpt: 花了一个多小时来写这个玩意,但是作为第一节,可以作为后面章节的模板, 所以构思了一下内容逻辑和内容布局样式,不过总的来说还是值得花点时间的。
tags: []
rating: ⭐⭐⭐
destination: 03-Projects/黑曜石玩家指南
created: 2025-08-30T11:45
updated: 2025-09-22T13:27
---
```ad-info
title: 友情提示
此部分内容主要是下载所需的软件、插件和模板,估计耗时5分钟。
```
### obsidian 安装
![[Pasted image 20220321141509.png]]
obsidian 截至目前(2022年3月21日)仍然是开源免费的笔记软件。
它可以在 Windows、Linux、macOS多种系统平台上使用。虽然它也有移动设备版本,但是考虑到个人知识库的 heavy 的特点,我仍然建议您以使用桌面客户端为主。**本教程以 Windows 11 操作系统为例展开**,其它操作系统大同小异。
```ad-warning
Mac操作系统容易遇见 python 环境配置问题,解决办法参考[issue 20](https://github.com/sheldonxxd/obsidian_vault_template_for_researcher/issues/20#issuecomment-1128860155).
```
另外 obsidian 也有一些付费功能,如果您有发布和云同步的需求,可以购买使用。
请您先不要理会网上一大堆关于「双链笔记」的说明,「双链」这个概念现在咱们还用不着。
在 [obsidian 官网](https://obsidian.md/)下载了安装包之后,直接一路默认安装即可。由于真正占用存储空间的个人资料以及主题插件都保存在指定的目录下,所以您可以放心把它安装到 C 盘,而无需担心长时间使用之后 C 盘空间不足的情况。
### obsidian模板库下载
![[Pasted image 20220321143352.png]]
本教程以 「obsidian_vault_template_for_researcher」为模板库展开,此模板库目前由本人维护,它整合了「写日志」和「文献阅读」工作流所需的一些插件和功能,并完善了相应的配置,最大程度降低了初学者的使用门槛,力求达到「开箱即用」的地步。
您可以到 github 仓库下载[最新的 release ](https://github.com/sheldonxxd/obsidian_vault_template_for_researcher/releases)直接解压到您打算长期存放个人资料库的磁盘目录下即可。
本人将资料库存放于移动固态硬盘中,并将硬盘盘符自定义为`X`,然后将资料库解压存放于`X:\projects`目录下,并把该 vault 重命名为 `working`。您可以按照个人喜好选择存储方案和仓库命名。**后续模板库路径均以`X:\projects\working`为例**。
```ad-warning
title: 更新请注意
对于已经使用该模板库早期版本的用户,一般而言,由于涉及修改的文件主要是插件配置代码等与个人资料无关的内容。您可以直接下载最新的 release 覆盖之前的库进行更新。但是请注意 [[README]] 文档中的说明,如果您自己有自定义的流程或插件配置方面的修改,则不建议更新。
```
### zotero 安装
![[Pasted image 20220321142732.png]]
zotero 是老牌的文献信息管理软件,同样是开源免费,而且多平台可以使用的一个工具,它的功能与 endnote 和 mendeley 等软件类似,都可以在写论文时插入参考文献,但是更加强大。截至2022年3月21日,zotero 版本号已经到 6.0,与之前最大的区别在于提供了内嵌的 pdf 阅读器。
在 zotero 官网下载软件包后同样默认安装即可,因为占大头的 pdf 附件我们后面会指定存储到 obsidian 的 vault 库中。
### zotero插件下载
- [Zotfile](https://github.com/jlegewie/zotfile/releases):自动 rename 附件,然后复制到制定目录,还能从 pdf 中提取高亮注释。请下载最新的 release 中提供的后缀为 `.xpi` 的文件。
- [Mdnotes](https://github.com/argenos/zotero-mdnotes/releases):将文献记录按照模板生成 markdown 笔记。
- [Better Bibtex](https://github.com/retorquere/zotero-better-bibtex/releases/tag/v5.5.4):生成 citation key,导出为更好的 bibtex 记录,也可以是 json,配合 obsidian 的 citations 插件使用。请下载最新的 release 中提供的后缀为 `.xpi` 的文件。
### anaconda安装与配置
一些自定义功能依赖于 python 脚本代码实现,建议下载安装 anaconda [清华TUNA镜像源](https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-2021.11-Windows-x86_64.exe))并将其添加到环境变量(安装时全打勾)。
![[Pasted image 20220529151825.png|450]]
```ad-warning
title: anaconda安装重要提示
如果你并不熟悉python,并且是首次安装 anaconda,如上图所示的界面中,务必勾选第一个将 anaconda 添加入 PATH,不然会导致 python 脚本无法正确调用。
```
使用cmd命令行工具安装以下 python 模块:
```bash
conda activate base
pip install pyperclip bibtexparser
```
```ad-warning
anaconda 虽然包含了大量所需的模块(如requests 和 pillow),但本模板库内使用的代码还需 pyperclip 和 bibtexparser 以支持粘贴板交互和读写 bib 文件。
```
### pandoc 安装与配置
pandoc 也是一个免费开源的工具,主要功能就是提供文件格式转换。比如我们可以把 markdown 格式的文件,通过pandoc导出为 word 文档或者可以断网独立访问的 html 页面。您可以到[pandoc官网](https://pandoc.org/installing.html)下载适合自己操作系统的安装包。一路默认安装,并注意添加到系统环境变量。
![[Pasted image 20220322144959.png]]
安装结束后,可以`Win+R` 运行 cmd,输入命令`pandoc --version` 查看安装信息。本教程用到的 pandoc 版本信息如上图所示。
```ad-info
title: 下节预告
当你已经完成了 obsidian 和 zotero 的安装,下载了指定的模板库并解压到您喜欢的存储介质和地址,如`X:\projects\working`,接下来,在使用之前,您还需要一些简单的设置建立 obsidian 和 zotero 之间的联动。详见[[zotero-obsidian联动配置]]。
```
---
page:: 1