一套面向数学、深度学习、强化学习、信息论、组合优化与量化研究的中文 Obsidian 配置。它把 LaTeX 讲义的秩序感带进 Markdown,但刻意减少大面积彩色卡片:正文负责理解,卡片只负责真正的重点。
点击图片查看完整 渲染范本 PDF — 六类学科示例的完整渲染效果(PPO 裁剪、信息论、深度学习张量、组合优化建模、量化回测),与 Obsidian 阅读视图 / PDF 导出完全一致,已覆盖中文字体回退与深浅色模式。
-
下载本仓库 ZIP,解压后用 Obsidian 打开这个文件夹;或运行:
git clone https://github.com/KafukaTree/KFKObsidian.git
-
打开
examples/00_样式总览.md。CSS 片段已经在仓库设置中启用。 -
复制
templates/学习笔记_raw.md开始速记;需要整理时,让 Agent 使用skills/kfk-note-polisher。
只想给已有 Vault 加样式?复制:
.obsidian/snippets/kfk-note-system.css
到你的 Vault 同名目录,然后在“设置 → 外观 → CSS 代码片段”中启用 kfk-note-system。
| 目录 | 内容 |
|---|---|
.obsidian/ |
最小可移植设置与 CSS;不包含个人工作区和插件缓存 |
templates/ |
raw 速记与正式学习笔记模板 |
examples/ |
六个跨学科中文示例及一组 raw → 成稿示例 |
docs/ |
快速开始、语义环境速查、Agent 使用手册 |
skills/kfk-note-polisher/ |
供 Codex/Agent 读取的规范化笔记润色 Skill |
| 层级 | 形状 | 典型类型 |
|---|---|---|
| 核心强调 | 浅粉完整卡片 | keyformula、claim、keyidea、takeaway |
| 轻提示 | 无背景、左侧细线 | question、assumption、implementation、risk |
| 正式数学 | 粉/橙/蓝完整卡片 | theorem、definition、example |
| 行内环境 | 无卡片背景 | note、proof |
一篇普通技术笔记通常只需要 2–5 个核心卡片。完整选型见 语义环境速查。
> [!question] 问题
> 当前真正需要回答的问题。
> [!keyformula] 关键公式
> $$
> I(X;Y)=D_{\mathrm{KL}}(p(x,y)\|p(x)p(y)).
> $$
> [!risk] 风险
> 会使结论失效的条件。Obsidian 的 Callout 语法要求每行以 > 开头。日常只写 raw 笔记即可,不必手工完成全部排版;Agent Skill 会负责结构化。
将 skills/kfk-note-polisher 复制到 Codex Skill 目录,例如:
~/.codex/skills/kfk-note-polisher/
然后使用:
使用 $kfk-note-polisher,把 PPO裁剪_raw.md 润色为一份中文学习笔记。
保留我的疑问和不确定项,不要虚构出处。
详细说明见 Agent 使用手册。
- 核心样式只依赖 Obsidian 原生 Markdown、MathJax 与 Callout。
- Excalidraw 可选;CSS 已支持嵌入图居中。
- TikZJax、Completr 等插件都不是必需项,因此仓库不打包第三方插件代码。
- 插件选择与安装原则见 可选插件。
- 支持阅读视图、Live Preview、浅色/深色模式与 PDF 导出。
- 中文字体优先使用系统已有的
Noto Serif SC、思源宋体或楷体,并提供 Windows 回退字体。
仓库不包含个人工作区布局、插件数据、历史记录、私有笔记或 API 密钥。复制自己的 Vault 到公开仓库前,仍请先检查附件、Frontmatter、链接与 Git 历史。
