快速开始

什么是 MarkdownFlow？

MarkdownFlow（也称为 MDFlow 或 markdown-flow）通过 AI 扩展了标准 Markdown，用于创建个性化的交互式页面。我们的口号是：“一次创作，千人千面”。

您不再编写静态内容给读者，而是为 AI 智能体编写提示词。这些智能体会根据每位用户的选择、偏好和上下文，将您的指令转化为个性化内容。

与 Markdown 完全兼容

MarkdownFlow 不是 Markdown 的替代品——它是自然的扩展：

• ✅ 所有标准 Markdown 语法都不变
• ✅ 所有 Markdown 扩展（表格、任务列表、脚注）都正常工作
• ✅ 现有 Markdown 文档无需修改即可在 MDFlow 中使用
• ✅ 您喜爱的 Markdown 编辑器和工具链继续工作

您可以从任何现有的 Markdown 文档开始，并根据需要逐步添加 MDFlow 功能。

先掌握日常语法

MarkdownFlow 为标准 Markdown 增加了交互元素、确定输出和记忆：

记住核心原则

下面的所有示例都显示了AI 指令，而非直接的用户内容。您为 AI 写提示词来生成个性化内容。

1. 交互元素

按钮和输入框，用于收集用户选择。在同一 MarkdownFlow 文档中，可以在后续提示词中自然引用用户的回答。

询问用户的经验水平。
?[初学者 | 中级 | 专家]

根据用户刚才选择的经验水平，生成学习建议。

询问用户的爱好。可以是单选或多选。
?[电影 || 运动 || 阅读 || 旅行]

以友好的方式收集用户姓名。
?[...在此输入您的姓名]

了解更多： 交互的语法规则

2. 确定内容

在 AI 处理时保持其确切含义和风格的文本。

介绍我们的企业价值观，确保保留确切的座右铭：
===放大人类的永恒价值===

提供安装说明，保留确切的命令：
===npm install markdown-flow===

了解更多： 确定内容规范

3. 记忆

记忆以问题和回答的形式保存信息，供 AI 在后续生成中使用。把问题放在交互开头以保存回答，再在后续提示词中引用同一个问题：

询问用户的经验水平。
?[{{您的经验水平如何？}} 初学者 | 中级 | 专家]

根据 {{您的经验水平如何？}} 调整下一段讲解。

记忆的保存范围和可使用它的文档由平台决定。在 AI 师傅中，课程记忆可以在同一课程的不同小节间复用。

了解更多： 记忆规范

工作原理（简化版）

MarkdownFlow 智能体通过以下方式处理您的文档：

1. 读取您的 MDFlow 文档（AI 指令）
2. 整合读者在交互控件中的回答
3. 使用这些组合指令调用大语言模型
4. 生成每个读者独有的个性化内容

完整技术工作流程请参见： 规范说明

下一步？

准备深入了解？请按照以下学习路径：

1. 核心概念 - 了解基本原则
2. 快速上手 - 构建您的第一个交互式文档
3. 立即试用 - 通过实际示例练习
4. 下一步 - 探索高级功能并获得帮助

或者直接跳转到我们的 5分钟快速上手！