Bug 排查
在单篇笔记中收集日志、假设、命令和解决方案步骤。
- 错误输出记录
- 尝试过的方案
- 结果与跟进
场景
开发团队的应用场景
从独立项目到小型团队，都需要一块快速记录的空间来保持技术知识井然有序。
Bug 排查与分类
技术决策记录
代码片段与资源归档
技术决策记录
让决策背景、备选方案和依据在日后重新可寻。
- 决策摘要
- 备选方案
- 原委与潜在风险
个人知识库
让常用的命令、代码片段和链接井井有条。
- 命令速查本
- 常用代码片段
- 参考资源链接
Bug 排查
零散的 Bug 调研收拢为单篇可追踪的笔记。
在处理 Bug 时，终端输出、截图链接、试过的命令和临时假设往往散落在各处。MDNote.dev 将这些零碎的记录收集在同一篇 Markdown 笔记中。
- 清晰地写出错误条件
- 列出尝试过的解决方案
- 在结单时单列出真正的解决方案
决策记忆
微小的技术决策随时间累积成庞大的项目记忆。
并不是每个决策都需要正式的架构决策记录（ADR）格式。但如果记录了选择某个依赖包的原因、更改了哪个接口，或者为什么做了临时妥协，团队就能少走弯路。
- 分离决策与原委
- 保持备选方案简短
- 保留日后将迁移至文档的核心骨架
这一场景在小团队中能特别有效减少会议后灵感遗失的情况。
实用流程
MDNote.dev 在日常工作何处体现价值？
这些场景的共同纽带是：快速写下信息，并在日后轻松找到。
API 研究
整洁地记录接口行为、示例 Payload 和错误响应。
版本发布准备
在同一个草稿中汇总变更说明、风险和检查清单项。
学习日志
新库、新命令或架构决策随着时间推移转化为个人参考文档。
片段归档
存储频繁重复的代码片段及其解释说明。
常见问题
应用场景常见问题
MDNote.dev 应该取代团队 Wiki 吗？
对于长期和正式的文档，Wiki 或代码库文档可能更合适。MDNote.dev 针对快速捕获、个人准备和小型团队记忆更为轻量敏捷。
哪些笔记归入文件夹，哪些归入标签？
文件夹代表主要上下文，比如项目或客户；标签用于标记贯穿多个文件夹的主题。
它适合用来准备发布日志吗？
适合。您可以先在 Markdown 草稿中收集变更，然后再将其整理到产品文档或变更日志格式中。