产品介绍
产品概述
Notation 是一款专为开发者设计的命令行工具，其核心功能是将本地编写的 Markdown 文档自动发布到 Notion。它旨在让文档与代码紧密共存，通过简单的命令即可将文档同步至 Notion，从而利用 Notion 强大的搜索、AI、格式化和协作能力。其核心价值在于简化技术文档的发布流程，让开发者无需离开代码仓库或使用复杂的前端框架，就能创建出可供团队或公众访问的优质文档。
发展历史
暂无相关信息。提供的材料中未提及产品的成立时间、重要里程碑或融资历史。
产品功能
Markdown 到 Notion 的自动发布：通过命令行工具，将本地 Markdown 文件及目录结构一键同步至指定的 Notion 页面。 灵活的部署选项：可将文档作为内部页面保留在 Notion 工作空间，或发布为公开的 Notion 页面，亦可进一步通过 super.so 等服务部署为独立网站。 智能内容映射：支持通过 `intro.md` 文件将内容直接发布到父页面，而其他文件则自动生成为子页面，保持清晰的层级结构。 页面元数据定制：支持在 Markdown 文件顶部通过 CLI 参数（如 `--title`、`--emoji`）直接定义 Notion 页面的标题和图标。 广泛的 Markdown 支持：支持标题、段落、代码块、列表、表格、链接、图片（需外链）、以及指向仓库内其他页面的相对链接。
技术优势
Notation 的核心技术优势在于其极简、专注的设计哲学。它不试图构建一个完整的文档平台，而是巧妙地充当了本地 Git 仓库与 Notion 强大生态之间的“连接器”。这使得开发者可以继续使用最熟悉的 Markdown 和版本控制工作流，同时免费获得 Notion 提供的成熟 AI 搜索、美观排版、团队协作等复杂功能，无需自行开发和维护这些后端能力。
典型应用场景
项目技术文档：将 API 文档、开发指南等 Markdown 文件与代码库一同管理，并自动同步到 Notion 供整个团队查阅。 产品说明文档：为产品经理、用户等非技术人员创建易于访问和搜索的产品使用说明或帮助中心。 团队知识库：在代码仓库中维护团队知识库，并通过 Notation 发布到 Notion，结合 Notion 的协作功能进行共同编辑和管理。 个人笔记与博客：开发者可以用 Markdown 撰写技术笔记或博客文章，并快速发布到个人 Notion 空间或公开网站。
