Notation介绍
Notation是一款面向开发者的免费开源命令行工具，专为简化Markdown文档同步至Notion而设计，让技术文档真正实现‘文档即代码’。它支持将本地Markdown文件及目录结构自动转换并发布为格式美观、层级清晰的Notion页面，同时保留标题、代码块、表格、相对链接等语法，并能通过CLI一键触发更新，无缝集成CI/CD流程。工具无需前端框架或独立网站托管，直接复用Notion强大的搜索、AI协作与共享能力，显著降低文档维护成本，提升跨职能团队的信息可达性。
Notation网站截图
Notation的主要功能
- Markdown到Notion自动转换
- 保留本地目录结构映射为Notion嵌套页面
- 命令行驱动，支持CI/CD集成
- 支持自定义页面标题、emoji图标和intro内容
- 智能处理Markdown相对链接为Notion内部跳转
Notation如何使用
- 通过curl命令安装Notation CLI工具
- 在~/.notation/下创建Notation.toml配置文件，填入Notion API密钥和目标父页面名称
- 在Notion中创建集成并授权访问指定页面
- 在代码仓库中编写Markdown文档，按需组织目录结构
- 执行notation ship --src命令完成文档同步发布
Notation的应用场景
- 构建与代码库共存的内部工程维基
- 发布可公开访问的API开发者文档
- 为非技术人员（如产品、设计）提供易读易搜的技术指南
- 同步项目规范、会议纪要等全生命周期文档
- 管理个人技术笔记并发布至私有Notion知识库
