上周帮同事改一份 Photoshop 批量导出教程，他写了 3000 字，步骤列得密密麻麻，可新来的实习生照着操作还是卡在第三步——不是漏点了一个复选框，就是没注意到‘导出为’和‘导出设置’是两个不同入口。问题不在人，而在文档本身：字多≠有用，排版漂亮≠看得懂。
高质量不是堆字数，是解决真实卡点
真正的高质量指南文档，核心就一条：让第一次打开软件的人，5 分钟内完成一个最小闭环任务。比如教用 Typora 写 Markdown，别一上来讲语法树和渲染原理，直接上：
① 下载安装后双击打开；
② 按 Ctrl+N 新建文档；
③ 输入 # 我的第一个标题，回车后自动变大；
④ 按 Ctrl+Shift+P → 输入「导出 PDF」→ 回车搞定。
这四步里，每一步都对应一个真实动作、一个可见反馈。用户做完，心里有底了：哦，这玩意儿真能用。
三个立马能用的细节技巧
1. 截图只圈关键区域
别贴整张 1920×1080 的屏幕截图，用画图工具粗暴打个红框，箭头直指那个“勾选‘覆盖原文件’”的复选框。多余信息全删，眼睛不迷路。
2. 把「默认值」写进步骤里
很多教程写“点击确定”，但用户根本不知道弹窗里默认选项是什么。改成：“弹窗中保持‘格式：PNG’和‘质量：90%’不变，直接点确定”。少猜一次，少错三回。
3. 加一句「如果卡住，检查这个」
比如教用 OBS 推流：
如果预览窗口黑屏，先确认：
① 左下角‘开始录制’按钮旁是否显示‘未连接’；
② 右键‘来源’列表里的‘显示器捕获’→ ‘属性’→ ‘显示器’下拉框是否选对了你正在看的屏幕（不是笔记本自带屏）。这些不是补充说明，是主干步骤的一部分。因为用户遇到问题时，根本不会回头翻“常见问题”章节。
最后一点实在话
别追求“全面覆盖所有功能”。你写的是一份指南，不是软件说明书。Focus on one thing, do it well —— 教会用户用好「导出 PDF」，比罗列 27 种导出格式强十倍。下次写之前，先自己关掉所有参考文档，从零开始走一遍，卡在哪，就补哪。那才是用户真正需要的高质量。