1. Warp终端：命令和输出直接变成教程素材
以前写Docker部署教程，我得在终端跑一遍命令，再手动复制命令和输出到Markdown，格式乱还要一个个加代码块。Warp的Block机制解决了这个问题。每个命令和它的输出是一个独立块，右键选择“Copy as Markdown”，直接得到带```bash```围栏的代码块，连错误输出都保留颜色标记。
实操步骤：安装Warp后，跑完`docker compose up -d`，鼠标悬停在命令块上，点右上角三个点，选“Copy Command and Output as Markdown”，粘贴到Obsidian或Notion即可。更狠的是Command Palette里搜“Save Session as Markdown”，能把整个终端会话导出成一份教程初稿。我写《K3s单节点部署指南》时统计过：24条命令的排版从过去手动整理41分钟降到6分钟，错误复制率为0。
2. Shottr：免费截图工具，长截图和步骤标注吊打付费
技术教程离不开界面截图，但macOS自带的截图没有滚动截屏，也没有步骤编号。Shottr免费、轻量、快捷键可定制，最实用的是滚动截图和OCR。写API调试教程时，需要截完整的控制台日志，用Shottr按`Cmd+Shift+5`选窗口后按`S`，自动滚动拼接长图，输出PNG分辨率足够直接放博客。
实操：截完图后按`Cmd+3`进入标注模式，用文本工具在左上角加步骤数字“1、2、3”，再用箭头工具指向关键参数。Shottr的OCR可以直接选中图片里的文字复制出来，遇到报错信息不用手打。我之前写《Next.js 15部署踩坑集》，68张截图从截图到标注完成用了1小时12分，比之前用CleanShot X（付费）还快18分钟，主要赢在滚动截图不用分段拼。
3. Obsidian + Excalidraw：画架构图别开Figma，杀鸡用牛刀
很多人在写微服务或系统设计教程时，为了画一张好看的架构图去开Figma、Draw.io，结果光调对齐就浪费半小时。我的做法是直接在Obsidian笔记里用Excalidraw插件画，画完自动嵌入笔记，还能导出SVG给网页用。
实操步骤：Obsidian仓库中创建新笔记，输入`/excalidraw`插入画布。用内置矩形、箭头、数据库图标画拓扑，按住`Ctrl/Cmd+D`快速复制节点，连线时开启“吸附到节点”就不会画歪。画完点击右上角“Export SVG”存到附件目录，正文用`![[架构图.svg]]`嵌入。真实案例：我维护的《服务网格Istio实战》系列，15张架构图全部用Excalidraw画，改图时直接双击编辑，不用像Figma那样先上传再改再导出，平均每张图修改效率提高约3倍，版本管理也直接用Git，不会出现“最终版_v3_final”这种文件。
4. n8n：一次写完，自动同步公众号、知乎和掘金
多平台分发是技术教程创作者的隐形时间黑洞。每个平台排版规则不一样，代码块高亮、外链跳转、标题层级都要重新调。我搭了一条n8n工作流，只要把Markdown推到GitHub仓库，就自动转换成各平台草稿。
实操流程：n8n里创建Webhook节点，接收GitHub push事件；接一个“Read File from Disk”读取最新教程MD；用“Markdown to HTML”节点转换；再分流到三个“HTTP Request”节点，分别调用公众号草稿接口、知乎发布草稿接口、掘金写作接口（这些平台现在都开放了API或可通过Cookie模拟）。最后加一个飞书机器人通知，把草稿链接推到我的“待发布”群。这条流程跑通后，我发一篇1500字教程的排版分发时间从平均96分钟缩到11分钟。即使你不懂n8n，也可以先用它的模板库搜“Markdown to WeChat”，改下账号参数就能用。
5. Raycast Snippets：把重复命令和模板变成一键触发
写技术教程时，很多内容片段是反复出现的：docker-compose模板、Nginx反向代理配置、常用Kubernetes YAML头。以前我专门开一个文本文件当“资料库”，需要时复制粘贴，还要改端口、路径。现在用Raycast的Snippets功能，把这些做成带占位符的片段。
实操：Raycast设置里搜Snippets，新建一个片段，关键词填`!k8sdeploy`，内容填入完整的Deployment YAML模板，把镜像名写成`${image}`。以后在编辑器输入`!k8sdeploy`，Raycast自动展开，光标跳到`${image}`位置等你填。我还建了`!nginxssl`、`!dockerfile-node`、`!compose-postgres`，每个片段都有使用计数。最近30天我的Snippets展开次数是347次，按每次复制粘贴加改参数平均15秒算，光这一项就省了86分钟。它支持代码块语法高亮，对写Markdown特别友好。
这五个工具组合下来，写一篇带代码、带截图、带架构图的技术教程，我的实际耗时从原来的6-8小时压缩到2.5-3小时，而且格式一致性更好。工具不在多，在于嵌进流程里真正跑起来。先把Warp和Shottr装上，你的教程产出速度当天就能感到变化。
📌 延伸阅读：2026年百科知识效率工具复盘：从离线维基到AI校验，少走一半弯路 | windows 关闭开机自启软件完整教程
以上就是本文的全部内容，希望对你有所帮助。如果有任何疑问，欢迎联系站长。