Markdown 被视为 AI 编程时代的“源代码”，建议纳入 /src 目录管理
2026/10/09 11:52阅读量 4
在 AI 辅助编程背景下，Markdown 文档因其结构化特性被重新定义为类似“源代码”的核心资产。文章主张将 Markdown 文件直接提交至代码仓库的 /src 目录，以实现与代码的同版本控制和紧密集成。这一观点强调了非代码文本在自动化构建和 AI 理解中的重要性。
事件概述
随着 AI 编程工具的普及，开发流程中对结构化数据的需求日益增加。Markdown 作为一种轻量级标记语言，其清晰的层级结构和语义化特征使其成为 AI 模型理解和生成代码的理想输入源。因此，有观点提出应重新审视 Markdown 在项目中的定位，将其视为与代码同等重要的“源代码”。
核心信息
- Markdown 的新角色：在传统开发中，Markdown 主要用于 README、API 文档或笔记。但在 AI 时代，它作为结构化的知识载体，能够被 LLM（大语言模型）高效解析，从而辅助代码生成、重构和测试用例编写。
- 提交至 /src 目录的建议：传统做法常将文档置于
/docs或根目录，导致其与具体代码模块分离。建议将 Markdown 文件直接放入/src目录下对应模块附近，确保文档随代码变更同步更新，并便于 CI/CD 流水线自动提取和处理。 - 版本控制的一致性：将 Markdown 纳入
/src有助于实现文档与代码的版本强绑定，避免文档滞后于代码逻辑的问题，提升团队协作效率和 AI 工具对上下文理解的准确性。
值得关注
- 该观点挑战了传统的目录结构规范，反映了 AI 原生开发流中对“文档即代码”理念的深化。
- 开发者需评估现有项目结构是否支持这种整合方式，特别是涉及静态资源生成和部署流程的调整。
- 此趋势可能推动更多团队采用内部 Wiki 或动态文档系统，以实时反映代码状态。