用Golang构建轻量Markdown笔记工具，以文件系统为数据库、goldmark解析、CLI为主Web为辅，支持front matter元数据、内存索引搜索及多格式导出。
用 Golang 构建 Markdown 笔记工具，核心在于轻量、可控、可扩展。它不依赖前端框架或数据库，靠标准库和少量第三方包就能跑起来，适合个人知识管理或离线写作场景。
文件系统即数据库
把笔记存为本地 Markdown 文件（如 notes/2024-05-12-架构思考.md），目录结构即分类逻辑。用 os.WalkDir 扫描文件，filepath.Base 提取标题，time.Parse 从文件名或 front matter 中解析时间。避免过早引入 SQLite 或 Bolt —— 文件读写足够快，且天然支持 Git 版本控制、全文搜索（grep / ripgrep）和编辑器直连。
解析与渲染分离设计
别把解析和 HTML 渲染耦合在一起。推荐用 goldmark（官方推荐的现代 Markdown 解析器）：它支持扩展（如表格、脚注）、可配置、无 CGO 依赖。自定义 renderer 可注入目录链接、自动锚点、代码块行号；用 goldmark-meta 插件提取 YAML front matter，用于排序、标签、状态字段（draft/published）。
CLI 为主，Web 为辅
- 命令行优先：提供 note new、note list --tag=go、note serve 等子命令，用 spf13/cobra 组织，交互简洁
- 内建静态服务：用 http.FileServer + 自定义 handler 支持 .md 实时转 HTML（带基本样式），不启动完整 Web 框架
- 导出友好：支持生成单页 HTML（含内联 CSS/JS）、PDF（通过 wkhtmltopdf 命令行调用）或纯文本摘要
元数据与搜索能力要务实
在每篇 Markdown 开头加简单 front matter：
立即学习“go语言免费学习笔记（深入）”；
--- title: Go 并发模型 tags: [go, concurrency] date: 2024-05-10 draft: false ---
用正则或 goldmark-meta 提取后构建内存索引（map[string][]Note）。搜索不必上 Bleve —— 对几百篇笔记，strings.Contains 全文扫描 + 标题/标签匹配已足够快。需要更准？加个 strings.Fields 分词 + 简单权重即可。
基本上就这些。Golang 做笔记工具，优势不在功能多，而在边界清晰、部署简单、代码易懂、修改自由。
