README file from
GithubMemoria 🪶
浮墨式碎片笔记插件 for Obsidian
数据永远是纯 Markdown,自由属于你。
简体中文 · English
📸 看起来像什么样
主视图(瀑布流 + 侧栏热力图 + 置顶笔记)

数据报告(365 天热力图、月度柱图、Top 10 标签、24 小时分布、有趣的发现)

年度全景(12 个月铺开的日历,点任一天跳回主视图看那天的笔记)

💭 为什么做这个
我想要一个随手记想法的地方。
不需要复杂的双向链接,不需要知识图谱,也不需要每条笔记都想着"放进哪个文件夹"。就是一个输入框、一个发送按钮,按时间倒序瀑布流显示,偶尔翻翻过去的自己。
但我同时希望:这些想法永远是我能随时 grep 的纯 markdown 文件。哪一天我不再用这个插件,不再用 Obsidian,甚至不再用电脑的图形界面——那些笔记还躺在硬盘上,文本编辑器打开就能读,命令行 grep 就能搜。
Memoria 就是这样一个插件:把"浮墨式的快速记录体验"搬进 Obsidian,数据落到你自己的 vault 里,存成最普通的 YYYY.md 文件。
✨ 它能做什么
随手记
- 输入卡片 +
Ctrl/Cmd+Enter发送 - 全局快捷键
Ctrl/Cmd+Shift+M任意位置唤出速记弹窗 - 图片:粘贴 / 拖拽 / 选择文件,自动入库为 vault 附件
- 标签联想(汇集 vault 所有标签)、列表 Tab 缩进、Enter 自动续行
- 草稿自动保存,重启不丢
随手翻
- 按天分组瀑布流,置顶自动置顶
- 侧栏 14 周热力图 ↔ 月历一键切换
- 预设视图:今天 / 本周 / 置顶 / 收藏 / 往年的今天 / 随机 5 条
- 组合搜索:
#标签 关键词空格分隔,多标签多关键词 AND
看见自己
- 数据报告独立标签页:365 天大热力图、月度分布、Top 10 标签、24 小时活跃、标签云
- 年度全景:12 个月完整日历铺开,看一整年的节奏
- 有趣的发现:最长连续打卡、最活跃的一天、夜猫子次数、年同比等
贴心细节
- 长笔记自动折叠,点"全文"展开
- 任务列表可勾选,自动回写 md
- 卡片右键菜单:置顶 / 收藏 / 编辑 / 引用 / 保存为图片 / 打开原文
- 删除可软删除到
_trash.md(可关) - 移动端:抽屉侧栏、长按编辑、表格选择器适配手指
📂 存储格式
Memoria 在指定文件夹下维护 YYYY.md 文件,采用「时间独占一行 + 内容缩进」格式:
# 2026
## 2026-04-25 周六
- 12:43
这是今天的第一条想法 #灵感
- 14:20
又想到了一件事
可以换行继续写,每一行都缩进 2 空格
- 15:47
> [!tip] callout / 任务列表 / 标题等块级语法都能正确渲染
- 16:30
- [ ] 任务列表也 OK
- [x] 自动勾选回写
每条 - HH:MM 开头是一条独立 memo。停用插件那一刻,笔记依然是完整可读的 md 文件。
🚀 安装
目前支持手动安装。从 Releases 下载最新版的三件套:
<Your Vault>/.obsidian/plugins/memoria/
├── main.js
├── manifest.json
└── styles.css
然后 Obsidian → 设置 → 第三方插件 → 启用 Memoria → 左侧 Ribbon 点 🪶 打开面板。
也可以用 BRAT 插件输入
i-iooi-i/obsidian-memoria自动安装和更新。
⌨️ 常用快捷键
| 动作 | 快捷键 |
|---|---|
| 发送当前输入 | Ctrl/Cmd + Enter |
| 快速记录(全局弹窗) | Ctrl/Cmd + Shift + M |
| 列表缩进 / 反缩进 | Tab / Shift+Tab |
| 进入编辑模式 | 双击卡片(移动端长按) |
| 退出编辑 | Esc |
🛠 开发
npm install
npm run dev # watch 模式
npm run build # 生产打包
📜 变更日志
详见 CHANGELOG.md。
📝 许可
Memoria,意思是「记忆」。
祝你的每一份记忆,都被温柔保存。