下一步

恭喜！您已经学会了 MarkdownFlow 的基础知识。这是您成为 MDFlow 专家的路线图。

🎯 选择您的路径

路径1：深入规范说明

掌握 MDFlow 语法和功能的每个细节。

建议阅读顺序：

1. 规范概览
   了解 MDFlow 作为 Markdown 扩展的定位

2. 工作原理
   学习技术处理工作流程

3. 变量
   掌握变量命名、赋值和使用模式

4. 按钮和输入
   探索所有交互元素选项

5. 确定输出
   控制内容保留和转换

路径2：从示例中学习

在不同领域中看到 MDFlow 的实际应用。

探索体验台：

• 在 play.mdflow.run 尝试交互式示例
• 实验不同的使用场景
• 查看实时渲染
• 复制和修改模板

路径3：开始构建

直接使用您喜欢的技术开始开发。

选择您的 SDK：

前端框架

• markdown-flow-ui - React/Next.js 组件
• remark-flow - React Markdown 处理器
• markdown-it-flow - Vue/Vanilla JS 解析器

后端解决方案

• Python SDK - FastAPI/Django 集成
• Go SDK - 高性能处理

集成详情： 集成指南

📚 最佳实践

编写有效的 MDFlow 文档

1. 从简单开始，迭代改进

# 版本1：基础
欢迎 {{name}}！

# 版本2：添加交互
欢迎！您的姓名是什么？
?[%{{name}}...输入姓名]
很高兴认识您，{{name}}！

# 版本3：添加个性化
欢迎！您的姓名是什么？
?[%{{name}}...输入姓名]

您来这里的目的是什么？
?[%{{goal}}学习|构建|探索]

为来 {{goal}} 的 {{name}} 生成一个温暖的欢迎。

2. 对 AI 指令要具体

# 太模糊 ❌
告诉用户关于 {{topic}} 的信息。

# 清晰具体 ✅
向 {{level}} 用户用恰好3段解释 {{topic}}：
1. 核心概念（50字）
2. 来自 {{industry}} 的实际示例（75字）
3. 他们今天可以采取的行动（50字）

3. 规划用户旅程

规划用户可能走的不同路径：

• 新用户 → 入门引导 → 基础功能
• 回头用户 → 跳过介绍 → 高级选项
• 专家用户 → 直接访问 → 高级功能

4. 测试边缘情况

始终考虑：

• 空输入
• 很长的输入
• 特殊字符
• 不同语言
• 意外组合

常见模式

渐进式披露

显示关于 {{topic}} 的基本信息。

想要更多详情？
?[%{{more}}是的，告诉我更多|不了，够了]

如果 {{more}} 是"是的"：提供深入解释
如果 {{more}} 是"不了"：总结并结束

上下文适应

使用来自 {{user_background}} 的类比解释 {{concept}}：
- 如果是技术：使用编程示例
- 如果是商业：使用市场场景
- 如果是创意：使用艺术隐喻

反馈循环

这有帮助吗？
?[%{{feedback}}非常有帮助|有些帮助|没有帮助]

如果"没有帮助"：询问他们需要澄清什么
如果"有些帮助"：提供额外资源
如果"非常有帮助"：建议下一个话题

🛠 开发技巧

1. 版本控制

在 Git 中跟踪您的 MDFlow 模板：

# 好的实践：分离模板
templates/
  onboarding.md
  tutorial.md
  feedback.md

2. 模板组织

# 模板头部
<!--
  模板：用户入门
  版本：1.2.0
  变量：name、role、experience
  最后更新：2024-03-15
-->

# 内容从这里开始...

3. 变量文档

跟踪您的变量：

<!-- 使用的变量：
  {{user_name}} - 用户的显示名称
  {{user_role}} - 选择的角色（学生/教师/管理员）
  {{course_id}} - 当前课程标识符
-->

4. 测试策略

为您的模板创建测试用例：

const testCases = [
  { name: "Alice", role: "student", level: "beginner" },
  { name: "Bob", role: "teacher", level: "expert" },
  { name: "特殊字符测试", role: "admin", level: "intermediate" }
];

🤝 获得帮助和联系

社区资源

• GitHub 仓库 - github.com/ai-shifu/markdown-flow
• Discord 社区 - 参与讨论并获得帮助
• Stack Overflow - 标签：markdown-flow

保持更新

• 关注我们的博客获取教程和更新
• 订阅新闻通讯了解新功能
• 查看更新日志获取最新版本信息

贡献

MDFlow 是开源的！贡献方式：

1. 报告错误 - 帮助我们改善稳定性
2. 建议功能 - 分享您的使用场景
3. 提交示例 - 展示您构建的内容
4. 改善文档 - 帮助他人学习
5. 创建 SDK - 支持新平台

🚀 高级话题

准备更多内容？探索这些高级概念：

自定义处理器

学习使用自定义处理逻辑扩展 MDFlow：

• 预处理钩子
• 自定义变量解析器
• 后处理转换

集成模式

• CMS 集成
• API 驱动内容
• 数据库支持的变量
• 多语言支持

性能优化

• 模板缓存策略
• 延迟加载技术
• 包大小优化
• 服务器端渲染

分析和洞察

跟踪用户如何与您的 MDFlow 内容交互：

• 选择分析
• 路径分析
• 完成率
• A/B 测试

📋 快速参考

重要链接

• 体验台 - 在线试用 MDFlow
• 规范 - 完整语法参考
• SDK - 开发库

速查表

# 变量
{{variable_name}}                          # 使用变量
?[%{{var}}...]                            # 将输入存储在变量中

# 按钮
?[选项1|选项2]                             # 简单按钮
?[%{{var}}选项1|选项2]                     # 存储选择
?[按钮文本//值]                            # 不同的显示/值

# 输入
?[...输入文本]                             # 文本输入
?[%{{var}}...输入文本]                     # 存储输入文本

# 确定内容
===确切文本===                             # 保留格式/含义

# 组合
?[%{{choice}}是|否|...其他]                # 按钮 + 输入

🎓 最终提示

1. 从小开始 - 先构建简单模板
2. 经常测试 - 尝试不同用户路径
3. 获得反馈 - 与真实用户分享
4. 迭代改进 - 基于使用情况改进
5. 分享 - 帮助社区成长

记住： 目标是创建适应每个读者的内容，让他们的体验个性化且引人入胜。

准备构建了吗？

您现在拥有创建出色 MDFlow 体验所需的一切：

✅ 理解核心概念
✅ 通过示例实践
✅ 访问工具和资源
✅ 持续学习的清晰路径

今天就开始创建您的第一个真实项目吧！

返回 快速开始 | 跳转到 体验台