《张鑫旭12年技术写作经验》live 笔记

原视频： 张鑫旭12年技术写作经验分享｜创作者训练营第四期

1、选题

避免“搞个大新闻”的冲动。

避免完美主义，不要总想着准备的完美之后才进入行动。

避免写让所有人都满意的文章，所有人都满意一定中庸。

1.1 写作选题

（1、4、5适合新人）

1. 新特性、新方法介绍
2. 自认为厉害的小技巧、小创造
3. 原理剖析、深入理解
4. 技术方案汇总
5. 棘手问题解决经验分享
6. 优秀框架、项目、工具的体验指南

1.2 选题建议

1. 选题与自己学习相关

   • 写作是学习的辅助手段
   • 容易坚持，就算没人看，自己收获了成长

2. 不要写雷同内容

   • 同一个知识点从不同点切入

3. 迷茫的时候写写个人故事、感悟与困惑

   • 既能寻找答案，又能获得访问

2、你写作目的是什么?

2.1 如果是功利写作?

为了升职加薪，为了换工作，为了出名

重点突出

一眼扫去知道你在讲什么

• 讲结论的结论先行;
• 将交互的效果先放;
• 罗列知识的目录清晰;

有闭环有递进

完整的故事化表达

• 背景，思考，尝试，困难，解决与结果;
• 困难分1、2、3，解决后又出现了什么新问题;

2.2 如果是日常写作?

为了学习与自我成长，个人展现，遵循自己内心

如果你拥有足够的写作自由，多些真诚，少些套路真心，想分享的心比什么乱七八糟的技巧都管用

3、关于语言表达

3.1 技术文章的语言表达，什么最重要？

是换位思考

如果我是小白，这些术语懂吗?

如果我是读者，好理解吗?

是不是用个耳熟能详的东西类比下？是不是代码要简化下，加上注释？是不是这里应该放个图？是不是这里应该加个演示？

3.2 展现真实的自己

融入情感

除了是工作汇报、团队账号这样的严肃场景，否则一定是融入了个人情感的文章更有价值！有些人把写论文的经验带入到写博客上，导致博客很枯燥。

例如：我遇到了什么样的问题？我是怎么思考的？我又是怎么解决的？

又例如：我觉得这个技术如何？我不太喜欢某某设计？我的建议是什么？

你是什么样的人，就使用什么样的风格！

我话痨，喜欢扯东扯西，你就这么干，想到什么讲什么！

我御宅族，挺好，文章可以体现各种宅元素。

我喜欢晒自己，那文章配图就多多展现。

我是穷酸小透明，过得不如意，文章就不必强颜欢笑，透露出忧郁挺好！

保持一致的风格和特色

不要这篇嘻嘻哈哈，那篇文章干干巴巴！

1. 糟糕的风格好于毫无风格
2. 让别人记住你，提高影响力
3. 是防盗版的手段之一

4、关于文章质量

4.1 10 篇水文不如 1 篇高质量文

配图与实例

除了内容本身质量以外，有没有其他提高文章质量的技巧?

4.2 对每一句话负责

出现了不确信的结论，一定要自己验证一遍，对结论负责，特别是细节的地方，你比别人优秀的地方，一定比别人花费了更多的精力。

4.3 追寻内心而不是热门

文章质量和访问量并不正相关

例如：<面试技巧，N 个特性汇总>这样的文章容易高赞，但这些文章作者我一个都没记住。