问小白可生成开箱即用的markdown技术文档，需先输入三行锚点明确上下文，再按结构模板型或角色+目标型提示词驱动，插入代码块、参数表格与注意事项折叠区，并通过术语对齐、错误码校验和渲染预览确保交付质量。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在15分钟内产出一份带代码块、参数表格和注意事项折叠区的可交付技术文档，而不是花半天时间手动调整缩进、补反引号、对齐表格——问小白能直接生成开箱即用的Markdown源码，且严格遵循你指定的结构和术语规范。
准备原始材料与明确目标
打开问小白网页版或App，登录后新建空白文档。不要直接点“智能写作”，先手动输入三行关键锚点：
① 文档类型：API接口文档；
② 目标读者：第三方SaaS集成商；
③ 核心障碍：OAuth2.0令牌刷新机制不透明、分页参数易混淆。
这三行文字是AI理解上下文的【不可跳过的前提条件】，空文档直接触发生成会导致输出缺少状态码说明、遗漏认证流程图解等硬性模块。
选择最适合的提示词驱动方式
方法一：结构模板型（推荐用于单接口）
在文档中写好接口路径，例如“POST /v2/users”，将光标置于该行末尾→点击右上角“智能写作”按钮→输入：“按【请求方法】【路径参数】【请求头】【请求体示例】【成功响应】【错误码表】六模块生成。其中‘错误码表’必须包含40001(用户名重复)、40002(密码强度不足)、40101(access_token过期)三行，每行格式为‘错误码|含义|解决方式’。”
【注意：原始接口定义里出现的错误码必须原样写进提示词，AI不会自动从上下文提取】
方法二：角色+目标型（适合认证、安全类模块）
新建段落→输入：“你是一位有5年API平台经验的DevRel工程师，正在为金融级SaaS产品编写认证文档。请输出OAuth2.0授权码模式全流程说明，包含：①前端重定向URL构造规则（含state参数防CSRF要求）；②后端token交换请求体字段清单（client_id必填、code有效期≤10分钟）；③响应体中access_token、refresh_token、expires_in三字段的用途与存储建议。禁用‘我们建议’‘您可以’等模糊表述。”
插入并实测可运行代码
在生成的“请求体示例”区块下方，手动添加一行：```python；
把光标放在该行下方→点击“智能写作”→输入：“用Python requests库写出调用上述接口的完整示例，含headers设置、JSON payload构造、异常捕获逻辑，并在注释中说明每行作用。”
生成后，直接复制代码到本地环境执行一次——问小白生成的代码块默认带语言标识、缩进对齐、语义清晰，但【必须实测】，因为部分字段名可能与你真实服务端字段存在大小写差异。
校验术语一致性与逻辑完整性
第一步：全选文档→点击工具栏“术语对齐”功能（图标为两个交叠的字母A）→输入替换规则：“账号→user”“登录口令→password”“返回结果→response body”；
第二步：滚动检查所有“错误码表”，确认每一行都严格遵循“错误码|含义|解决方式”三段式，且40001/40002/40101全部出现；
第三步：点击右上角“渲染预览”→观察表格是否自动对齐、折叠区是否可展开、代码块是否高亮——若发现表格列错位或折叠失效，说明某处Markdown语法有误，返回原文定位缺失的|或空行。
