现在很多开发资料都不再只是 Word、PDF 或网页。README.md、CHANGELOG.md、AGENTS.md、CLAUDE.md、提示词笔记、接口说明、发布计划、AI 输出结果，越来越多内容都回到了一个简单的格式：Markdown。.md 文件的价值在于它既是普通文本，又能表达标题、列表、代码块、表格、链接和任务清单，适合人读，也适合工具和 AI 读取。
但在 Windows 上，.md 文件还有一个很现实的问题：双击之后经常只是打开纯文本。你可以用 VS Code 看预览，也可以把内容丢到在线编辑器里，但如果只是想快速打开一个本地 Markdown 文件、看排版、改几行、保存回去，用完整 IDE 会显得太重。基于这个需求，我做了一个本地软件：Markdown Docs。
官网在这里：markdowndocs.online
为什么 .md 文件适合现在的开发工作流
Markdown 不是新东西，但 AI 时代让它重新变得重要。原因很简单：
- 它是纯文本，能进 Git，diff 清楚。
- 它结构明确，标题、列表、代码块对模型很友好。
- 它没有复杂格式包袱，跨编辑器、跨平台都能打开。
- 它适合放项目规则、上下文、接口说明和可复用提示词。
比如一个项目里可能会同时出现这些文件：
README.md
CHANGELOG.md
CONTRIBUTING.md
AGENTS.md
CLAUDE.md
PROMPTS.md
TODO.md
这些文件看起来只是文档，实际上已经变成了项目知识库。开发者读它，AI coding agent 也读它。文档越清楚，团队和工具越不容易误解项目。
但 Markdown 的打开体验不应该很重
我自己遇到的问题是：很多时候我不想启动一个完整代码编辑器，只想像打开 PDF 一样快速打开 .md 文件，然后看到渲染后的效果。
在线 Markdown 工具适合临时检查，比如粘贴 AI 生成的表格、README 片段、说明文档，看看代码围栏有没有闭合、列表有没有乱掉。但长期使用本地文件时，本地软件更合适：
| 场景 | 在线编辑器 | 本地 Markdown 软件 |
|---|---|---|
| 临时粘贴预览 | 很方便 | 可以，但不是最轻 |
| 私有项目文档 | 不建议随便上传 | 更适合 |
双击打开 .md | 不支持 | 支持文件关联 |
| 保存到原文件 | 通常要下载 | 可以直接保存 |
| 日常阅读文档 | 一般 | 更顺手 |
这也是 Markdown Docs 想解决的核心问题：让 .md 文件在 Windows 上有一个轻、快、直接的打开方式。
Markdown Docs 做了什么
Markdown Docs 是一个面向 Windows 的 Markdown viewer/editor。它支持常见 Markdown 文件扩展名，包括 .md、.markdown、.mdown 和 .mkd。
它的重点不是做一个庞大的 IDE，而是围绕本地 Markdown 工作流做几件高频事情：
- 快速打开本地 Markdown 文件
- 编辑源码并实时预览
- 在分栏预览和完整预览之间切换
- 用工具栏插入标题、粗体、斜体、列表、表格、图片、链接等语法
- 对已保存文件自动保存
- 对未命名文件保存本地草稿，之后可以恢复
- 安装后把 Markdown 文件关联到软件，方便从 Windows Explorer 直接打开
官网也提供了在线 Markdown editor，用来临时上传、编辑、预览和下载 .md 文件。但对于私有项目文档、长期笔记、AI agent 配置文件，本地版会更安心。
为什么选择 Go + React
这个工具是用 Go + React 做的。这里的组合很适合桌面工具：
- Go 负责本地能力、文件读写、应用打包和稳定性。
- React 负责编辑器界面、工具栏、预览状态和交互。
- Markdown 渲染层负责把纯文本变成可读的文档预览。
我喜欢这个拆法，因为 Markdown 工具本身既需要“本地软件”的可靠性，也需要“前端界面”的灵活性。文件打开、保存、自动保存这些事情适合交给 Go；编辑体验、预览切换、按钮工具栏这些事情适合交给 React。
一个好的 Markdown 工具应该少打扰用户
Markdown Docs 的设计目标不是让用户学习一堆新概念，而是让 .md 文件像普通文档一样自然：
- 看到
.md文件，双击打开。 - 默认能看到清楚的预览。
- 需要修改时切到编辑或分栏。
- 改完自动保存或手动 Save As。
- 不想安装时，用在线编辑器做临时预览。
这类工具最重要的不是功能堆满，而是打开速度和流程短。Markdown 本身已经足够轻，工具也应该保持这种轻。
AI 让 Markdown 的使用场景变多了
现在 AI 工具经常输出 Markdown：方案列表、代码解释、表格、任务拆解、项目规则、提示词模板。很多时候我们会把这些内容保存成 .md 文件，放进项目目录或知识库里。
这时一个本地 Markdown 预览工具就很有用：
- 检查 AI 输出的表格是否渲染正确
- 阅读长篇技术说明而不是盯着源码文本
- 快速整理 prompt notes 和 agent instructions
- 给 README、AGENTS、CLAUDE 这类文件做轻量修改
- 在提交前预览文档结构
.md 文件正在从“开发者写 README 的格式”，变成“人和 AI 共享上下文的格式”。这也是我觉得它重要的原因。
小结
Markdown Docs 的出发点很简单：让 Windows 用户更快地打开、预览、编辑和保存 .md 文件。它不是要替代 VS Code，也不是要替代大型文档平台，而是补上一个日常小缺口：当你只是想快速查看或修改一个 Markdown 文件时，不需要启动一个很重的工作区。
如果你经常处理 README、AI prompt、项目规则、接口说明、任务清单或本地技术笔记，可以试试这个工具：
我后面也会继续围绕 Markdown、AI 文档、本地文件工作流继续改进它。.md 看起来只是一个文件扩展名，但在现在的开发环境里，它越来越像项目知识的通用容器。
