写可运行文档赢大奖！MoonBit 征文活动全面开启
还在为传统技术文档的维护成本头疼？想让你写的教程自带代码验证功能？现在参与MoonBit Pearls征文活动，创作一篇能编译、可测试、可调试的.mbt.md文档，就有机会获得定制周边、官方认证，甚至成为MoonBit工具链的标杆示例——这可能是你今年做过最具未来感的文档实验！
一、什么是可运行文档？重新定义技术写作
1.1 代码与文档的深度融合
传统开发流程中，文档与代码往往存在「滞后性鸿沟」：代码迭代后文档未更新、示例代码无法运行等问题频发。MoonBit创新的.mbt.md格式实现了文档即代码的突破，让Markdown中的代码块成为可编译的工程模块。
1.2 MoonBit 的实践创新
通过特殊的语法标记，开发者可以在文档中：
实时验证代码逻辑
嵌入交互式测试用例
生成动态流程图与API文档
这种写作方式让技术表达从单向传递升级为可验证的双向对话。
二、参与征文的三大核心价值
2.1 赢取开发者专属福利
成功入选作品将获得：
✅ MoonBit定制机械键盘/编程徽章套组
✅ 官方文档永久署名权
✅ 优先参与闭门技术研讨会资格
2.2 成为技术趋势引领者
据GitHub 2025开发者报告显示，支持可执行文档的工具使用率年增长达217%。参与本次活动即抢占以下先机：
掌握下一代文档工具使用范式
构建个人技术影响力新维度
加入开源生态建设者核心圈层
三、优质文档创作指南
3.1 结构设计四要素
评审团特别关注的黄金标准：
1. 模块化分层：功能说明→代码实现→测试验证的递进结构
2. 场景化示例：至少包含3个可独立运行的代码单元
3. 可视化辅助：利用注释生成UML图或状态机图示
4. 防御性写作：预埋常见错误用例及异常处理方案
3.2 效率提升技巧
使用MoonBit工具链的快捷指令：
//! [benchmark] 自动生成性能对比表格
/// |param| 交互式参数调节窗口
按Ctrl+Shift+V实时预览文档渲染效果
四、三步完成投稿
- 在MoonBit社区注册账号并创建公开Repo
- 使用.mbt.md格式编写文档（中英文皆可）
- 添加
MoonBitPearls标签提交至征文专区
截稿时间：2025年7月31日
结果公布：2025年Q3月度版本发布会
五、这就是未来写作的模样
当一份教程文档可以：
通过mbt test自动验证所有示例代码
用mbt build生成对应架构的二进制文件
执行mbt doc输出多种格式的技术手册
这意味着技术传播进入了自验证、自迭代、自交付的新纪元。
立即访问MoonBit官网获取参赛模板包，让你的文档作品不仅能够被阅读，更能被执行、测试与传承——下一次技术革新，或许就始于你正在书写的这一行代码！
