快速开始

什么是 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. 变量

用于共享上下文的进阶占位符。当某个值由平台提供，或需要跨不同 MarkdownFlow 文档共享时，才需要使用变量。

为 {{用户姓名}} 生成一条欢迎消息，以友好的语气提及他们当前的账户余额 {{余额}}。

对于交互控件，只有当答案需要被存储并跨文档使用时，才添加 %{{变量名}}：

?[%{{共享水平}} 初学者 | 中级 | 专家]

了解更多： 变量的语法规则

工作原理（简化版）

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

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

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

下一步？

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

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

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