llm_wiki/raw/How I use Obsidian.md

created, title, tags, source, description, author, published

created	title	tags	source	description	author	published
2026年3月26日 13:14	How I use Obsidian — Steph Ango		https://stephango.com/vault	My personal Obsidian vault template. A bottom-up approach to note-taking and organizing things I am interested in.

I use Obsidian to think, take notes, write essays, and publish this site. This is my bottom-up approach to note-taking and organizing things I am interested in. It embraces chaos and laziness to create emergent structure.我使用 Obsidian黑曜石来思考、做笔记、写文章和发布这个网站。这是我自下而上进行笔记和组织感兴趣事物的方法。它拥抱混乱和懒惰，以创造涌现的结构。

In Obsidian, a “vault” is simply a folder of files. This is important because it adheres to my file over app philosophy. If you want to create digital artifacts that last, they must be files you can control, in formats that are easy to retrieve and read. Obsidian gives you that freedom.在Obsidian中，“保险库”只是一个文件夹。这很重要，因为它符合我的“文件优先于应用”理念。如果你想创建持久存在的数字文物，它们必须是你可以控制的文件，并且格式易于检索和阅读。Obsidian为你提供了这种自由。

The following is in no way dogmatic, just one example of how you can use Obsidian. Take the parts you like.以下内容绝非教条，只是展示如何使用Obsidian的一个例子。请取其你喜欢的部分。

Vault template#保险库模板#

1. Download my vault or clone it from the Github repo . 下载我的保险库 或从 Github 仓库 克隆。
2. Unzip the .zip file to a folder of your choosing.将 .zip 文件解压到您选择的文件夹中。
3. In Obsidian open the folder as a vault.在Obsidian中，将文件夹打开为保险库。

• My theme Minimal with the Flexoki color scheme.我的主题是 Minimal最小化，搭配 Flexoki配色方案。
• Obsidian Web Clipper to save articles and pages from the web, see my clipper templates for specific sites I clip from. Obsidian Web Clipper黑曜石网页剪辑器 用于保存网页上的文章和页面，请查看我针对特定网站的 剪藏模板。
• Obsidian Sync to sync notes between my desktop, phone and tablet. Obsidian 同步，用于在桌面、手机和平板之间同步笔记。
• Obsidian Bases to view notes by category. Obsidian Bases黑曜石基础 查看按类别整理的笔记。
• Obsidian Maps for maps used in some of my templates. Obsidian Maps黑曜石地图 用于我的一些模板中的地图。

Personal rules#个人规则#

Rules I follow in my personal vault:我在个人保险库中遵循的规则：

• Avoid splitting content into multiple vaults.避免将内容拆分成多个保险库。
• Avoid folders for organization.避免使用文件夹进行组织。
• Avoid non-standard Markdown.避免使用非标准的Markdown。
• Always pluralize categories and tags.始终将类别和标签复数化。
• Use internal links profusely.大量使用内部链接。
• Use YYYY-MM-DD dates everywhere.在所有地方使用 YYYY-MM-DD 日期格式。
• Use the 7-point scale for ratings.使用7点评分量表。
• Keep a single to-do list per week.每周保持一个 待办事项列表。

Having a consistent style collapses hundreds of future decisions into one, and gives me focus. For example, I always pluralize tags so I never have to wonder what to name new tags. Choose rules that feel comfortable to you and write them down. Make your own style guide. You can always change your rules later.拥有一个 一致的风格可以将数百个未来的决策简化为一个，并让我保持专注。例如，我总是将标签变为复数形式，这样我就不用再为新的标签命名而烦恼。选择让你感到舒适的规则，并将它们写下来。制定你自己的风格指南。你以后总是可以更改你的规则。

Folders and organization#文件夹和组织#

I use very few folders. I avoid folders because many of my entries belong to more than one area of thought. My system is oriented towards speed and laziness. I don’t want the overhead of having to consider where something should go.我使用的文件夹非常少。我避免使用文件夹，因为我的许多条目属于多个思维领域。我的系统注重速度和懒惰。我不想花费精力去考虑某个条目应该放在哪里。

I do not use nested sub-folders. I do not use the file explorer much for navigation. I mostly navigate using the quick switcher, backlinks, or links within a note.我不使用嵌套的子文件夹。我不太使用文件资源管理器进行导航。我主要使用快速切换器、反向链接或笔记内的链接进行导航。

My notes are primarily organized using the categories property. Categories display an overview of related notes, using the bases feature in Obsidian.我的笔记主要使用 categories 属性进行组织。类别通过Obsidian中的 bases基础功能展示相关笔记的概览。

Most of my notes are in the root of the vault , not a folder. This where I write about my personal world: journal entries, essays, evergreen notes, and other personal notes. If a note is in the root, I know it’s something I wrote, or relates directly to me. 我的大部分笔记都存放在保险库的根目录下 ，而不是一个文件夹中。这里记录了我个人的世界：日记条目、散文、 常青笔记以及其他个人笔记。如果一个笔记在根目录下，我知道那是我写的，或者直接与我相关。

Two reference folders I use:我使用的两个参考文件夹：

• References where I write about things that exist outside my world. Books, movies, places, people, podcasts, etc. Always named using the title e.g. Book title.md or Movie title.md . 参考文献 ，我在其中写关于我世界之外的事物。书籍、电影、地点、人物、播客等。总是使用标题命名，例如 Book title.md 或 Movie title.md 。
• Clippings where I save things other people wrote, mostly essays and articles. 剪报 ，我保存别人写的东西，主要是文章和论文。

Three admin folders exist so that their contents don’t show up in the file navigation:存在三个管理员文件夹，以便其内容不会显示在文件导航中：

• Attachments for images, audio, videos, PDFs, etc. 附件 ，包括图片、音频、视频、PDF等。
• Daily for my daily notes, all named YYYY-MM-DD.md . I do not write anything in daily notes, they exist solely to be linked to from other entries. 每日 用于我的日常笔记，所有文件均命名为 YYYY-MM-DD.md 。我在日常笔记中不写任何内容，它们的存在只是为了从其他条目中链接。
• Templates for templates. 模板 的模板。

Two folders are present in the downloadable version of my vault for the sake of clarity. In my personal vault, these notes would be in the root, not a folder.在可下载版本中，我的保险库中有两个文件夹，以便于清晰。在我的个人保险库中，这些笔记会放在根目录下，而不是一个文件夹中。

• Categories contains top-level overviews of notes per category (e.g. Books, Movies, Podcasts, etc). 类别 包含每个类别的笔记概览（例如：书籍、电影、播客等）。
• Notes contains example notes. 笔记 包含示例笔记。

Links#链接#

I use internal links profusely throughout my notes. I try to always link the first mention of something. My journal entries are often a stream of consciousness cataloging recent events, finding connections between things. Often the link is unresolved , meaning that the note for that link isn’t created yet. Unresolved links are important because they are breadcrumbs for future connections between things.我在笔记中大量使用内部链接。我尽量总是链接第一次提到的事物。我的日记条目通常是意识流的记录，记录最近的事件，寻找事物之间的联系。通常链接是 未解决的 ，这意味着该链接的笔记尚未创建。未解决的链接很重要，因为它们是未来事物之间连接的线索。

A journal entry in the root of my vault might look something like this:我的保险库根目录中的日记条目可能看起来像这样：

I went to see the movie [[Perfect Days]] with [[Aisha]] at [[Vidiots]] and had Filipino food at [[Little Ongpin]]. I loved this quote from Perfect Days: [[Next time is next time, now is now]]. It reminds me of the essay ...

The movie, movie theater, and restaurant each link to entries in my References folder. In these reference notes I capture properties, my rating, and thoughts about that thing. I use Web Clipper to help populate properties from databases like IMDB. The quote was meaningful to me, so it became an evergreen note in my root folder. The essay I mention is in my Clippings folder, because I didn’t write it myself.电影、电影院和餐厅都链接到我的 参考文献 文件夹中的条目。在这些参考资料中，我记录了事物的属性、我的评分以及对它的想法。我使用 网页剪辑器从IMDB等数据库中获取属性。这句话对我来说很有意义，因此它成为了我根文件夹中的一个 常青笔记。我提到的文章在我的 剪报 文件夹中，因为我没有自己写这篇文章。

This heavy linking style becomes more useful as time goes on, because I can trace how ideas emerged, and the branching paths these ideas created.这种重链接风格随着时间的推移变得更加有用，因为我可以追踪想法是如何产生的，以及这些想法所创造的分支路径。

Fractal journaling and randomization are how I tame the wilderness that a knowledge base can grow into.分形日记和随机化是我驯服知识库可能生长成的那种荒野的方法。

Throughout the day I use Obsidian’s unique note hotkey to write individual thoughts as they come up. This shortcut automatically creates a note with the prefix YYYY-MM-DD HHmm to which I may add a title that describes the idea.一整天，我使用Obsidian的 独特笔记 快捷键来记录随时涌现的独立想法。这个快捷键会自动创建一个带有前缀 YYYY-MM-DD HHmm 的笔记，我可以在此基础上添加一个描述该想法的标题。

Every few days I review these journal fragments and compile the salient thoughts. I then review those reviews monthly, and review the monthly reviews yearly (using this template ). The result is a fractal web of my life that I can zoom in and out of at varying degrees of detail. I can trace back where individual thoughts came from, and how they bubbled up into bigger themes.每隔几天，我会回顾这些日记片段，并整理出重要的想法。然后，我会每月回顾这些总结，每年再回顾这些月度总结（使用 这个模板）。最终，形成了一个关于我生活的分形网络，我可以根据不同的细节程度进行放大和缩小。我可以追溯每个想法的来源，以及它们是如何逐渐发展成更大主题的。

Every few months I set aside time for a “random revisit”. I use the  random note  hotkey to quickly travel randomly through my vault. I often use the local graph at shallow depth to see related notes. This helps me revisit old ideas, create missing links, and find inspiration in past thoughts. It’s also an opportunity to do maintenance, like fix formatting based on new rules in my personal style guide.每隔几个月，我会留出时间进行“随机回顾”。我使用“随机笔记”快捷键快速随机浏览我的笔记库。我经常使用浅层深度的地方图来查看相关笔记。这有助于我回顾旧想法，创建缺失的链接，并在过去的思考中找到灵感。这也是进行维护的机会，比如根据我个人的风格指南中的新规则修复格式。

People have asked me if this could be automated with language models but I do not care to do so. I enjoy this process. Doing this maintenance helps me understand my own patterns. Don’t delegate understanding .有人问我是否可以用语言模型来自动化这个过程，但我并不想这么做。我喜欢这个过程。进行这样的维护有助于我理解自己的模式。 不要将理解委托给他人。

Properties and templates#属性和模板#

Almost every note I create starts from a template . I use templates heavily because they allow me to lazily add information that will help me find the note later. I have a template for every category with properties at the top, to capture data such as:几乎我创建的每一篇笔记都是从 模板开始的。我大量使用模板，因为它们允许我懒洋洋地添加信息，这些信息将帮助我以后找到笔记。我为每个类别都有一个模板，顶部有 属性，以捕获如下数据：

• Dates — created, start, end, published 日期 — 创建，开始，结束，发布
• People — author, director, artist, cast, host, guests 人物 — 作者、导演、艺术家、演员、主持人、嘉宾
• Themes — grouping by genre, type, topic, related notes 主题 — 按流派、类型、主题、相关笔记分组
• Locations — neighborhood, city, coordinates 位置 — 社区、城市、坐标
• Ratings — more on this below 评分 — 以下有更多介绍

A few rules I follow for properties:我遵循的一些关于属性的规则：

• Property names and values should aim to be reusable across categories. This allows me to find things across categories, e.g. genre is shared across all media types, which means I can see an archive of Sci-fi books, movies and shows in one place.属性名称和值应旨在跨类别可重用。这使我能够在不同类别中查找事物，例如 genre 在所有媒体类型中都是共享的，这意味着我可以在一个地方看到 科幻 书籍、电影和节目的档案。
• Templates should aim to be composable, e.g. Person and Author are two different templates that can be added to the same note.模板应旨在可组合，例如 Person 和 Author 是两个不同的模板，可以添加到同一个笔记中。
• Short property names are faster to type, e.g. start instead of start‑date .简短的属性名称更快输入，例如 start 而不是 start-date 。
• Default to list type properties instead of text if there is any chance it might contain more than one link or value in the future.默认情况下，如果有可能在未来包含多个链接或值，则应使用 list 类型属性，而不是 text 类型属性。

The .obsidian/types.json file lists which properties are assigned to which types (i.e. date , number , text , etc). .obsidian/types.json 文件列出了哪些属性被分配给哪些类型（即 date 、 number 、 text 等）。

Anything with a rating uses an integer from 1 to 7:任何带有 评分 的都使用从1到7的整数：

• 7 — Perfect , must try, life-changing, go out of your way to seek this out7 — 完美 ，必须尝试，改变生活，不遗余力地寻找
• 6 — Excellent , worth repeating6 — 优秀 ，值得重复
• 5 — Good , don’t go out of your way, but enjoyable5 — 好 ，不要刻意，但很愉快
• 4 — Passable , works in a pinch4 — 可接受 ，在紧急情况下可用
• 3 — Bad , don’t do this if you can3 — 不好 ，如果你能避免，请不要这样做
• 2 — Atrocious , actively avoid, repulsive2 — 可怕 ，积极避免，令人反感
• 1 —  Evil , life-changing in a bad way1 —  邪恶 ，以糟糕的方式改变生活

Why this scale? I like rating out of 7 better than 4 or 5 because I need more granularity at the top, for the good experiences, and 10 is too granular.为什么是这个刻度？我喜欢7分制而不是4分制或5分制，因为我在高分段需要更细致的区分，以体现良好的体验，而10分制则过于细致。

Publishing to the web#发布到网络#

This site is written, edited, and published directly from Obsidian. To do this, I break one of my rules listed above — I have a separate vault for my site. I use a static site generator called Jekyll to automatically compile my notes into a website and convert them from Markdown to HTML.本网站直接从Obsidian编写、编辑和发布。为此，我违反了上面列出的规则之一——我为我的网站有一个独立的保险库。我使用一个名为 Jekyll杰基尔的 静态网站生成器 ，自动将我的笔记编译成网站，并将它们从Markdown转换为HTML。

My publishing flow is easy to use, but a bit technical to set up. This is because I like to have full control over every aspect of my site’s layout. If you don’t need full control you might consider Obsidian Publish which is more user-friendly, and what I use for my Minimal documentation site .我的发布流程使用起来很简单，但设置起来有点技术性。这是因为我喜欢对网站布局的每个方面都拥有完全的控制权。如果你不需要完全的控制权，可以考虑使用 Obsidian Publish黑曜石发布，它更易于使用，而且我正在用它来发布我的 Minimal文档网站。

For this site, I push notes from Obsidian to a GitHub repo using the Obsidian Git plugin. The notes are then automatically compiled using Jekyll with my web host Netlify . I also use my Permalink Opener plugin to quickly open notes in the browser so I can compare the draft and live versions.对于这个网站，我使用 Obsidian Git黑曜石 Git插件将笔记从Obsidian推送到GitHub仓库。然后，这些笔记会自动使用 Jekyll杰基尔与我的网络主机 Netlify进行编译。我还使用我的 Permalink Opener永久链接打开器插件快速在浏览器中打开笔记，以便我可以比较草稿和实时版本。

The color palette is Flexoki , which I created for this site. My Jekyll template is not public, but you can get similar results from this template by Maxime Vaillancourt. There are also many alternatives to Jekyll you can use to compile your site such as Quartz , Astro , Eleventy , and Hugo .配色方案是 Flexoki，这是我为这个网站创建的。我的Jekyll模板不是公开的，但你可以从 这个模板中获取类似的结果，这是Maxime Vaillancourt制作的。此外，还有许多其他可以用来编译你网站的Jekyll替代工具，例如 Quartz石英、 Astro天体、 Eleventy十一和 Hugo雨果。

• File over app文件覆盖应用程序
• Concise explanations accelerate progress简洁的解释加速了进步
• Evergreen notes turn ideas into objects that you can manipulate常青笔记将想法转化为你可以操作的对象
• 40 questions to ask yourself every year每年要问自己的40个问题
• 40 questions to ask yourself every decade每个十年都要问自己的40个问题
• How I do my to-dos我如何处理待办事项