慕课网站开发与实现,wordpress 评分插件,慈溪建设局网站,校园网站建设方案模板下载简介#xff1a; 去年成为了内网技术分享平台的年度作者#xff0c;受邀写一篇关于“如何写好文章”的文章。我本身并不喜欢写字#xff0c;去年写的几篇文章#xff0c;涉及的话题自带流量#xff0c;所以阅读量多了一些#xff0c;谈不上有多擅长。不过还是决定分享一下…简介 去年成为了内网技术分享平台的年度作者受邀写一篇关于“如何写好文章”的文章。我本身并不喜欢写字去年写的几篇文章涉及的话题自带流量所以阅读量多了一些谈不上有多擅长。不过还是决定分享一下自己在写文章时用到的一些小技巧希望对大家有帮助。 作者 | 门柳 来源 | 阿里巴巴云原生公众号 去年成为了内网技术分享平台的年度作者受邀写一篇关于“如何写好文章”的文章。我本身并不喜欢写字去年写的几篇文章涉及的话题自带流量所以阅读量多了一些谈不上有多擅长。不过还是决定分享一下自己在写文章时用到的一些小技巧希望对大家有帮助。
最重要的是内容
和所有人强调的一样好文章最重要的是要有好的内容好的技术文章要让读者有益。如果你想写一篇爆款文章但是又觉得没有内容可写那就不要勉强了放下笔合上电脑有这个时间不如去看书打游戏。 如何让自己有源源不断的内容可写这与平时的积累有关多阅读多思考多写作真正的技巧无外乎这些。方法论层面的东西不再赘述我重点讲几个具体的小技巧直接“授之以鱼”。
优秀文章的特点
1. 阅读量 ≠ 文章质量
有些文章标题比较吸引眼球有些话题自带流量有些内容的受众比较广所以有很高的阅读量但这并不代表文章本身的质量。 前几天无意翻到一篇《超长用户行为建模在躺平家居内容推荐中的应用实践》我觉得写得不错但是内容我完全看不懂是专业领域的文章受众不多有上千的阅读量就已经很不错了。但是另一篇《如何画好一张架构图》就有超过 3W 的阅读量。当然反例也有很多就不再列举了。我自己写的几篇讲技术细节的文章就没有讲技术对比、讨论技术发展的文章阅读量高。内容越专越细能读下来的人就越少但并不代表文章质量不高反之亦然。 技术文章盲目追求阅读量和点赞数不是件好事所以第一个小建议就是不要太关注阅读量和点赞数写的文章对别人有用才是最有成就感的。至于除了阅读量和点赞数以外还有什么指标可以衡量一篇文章的好坏欢迎大家留言讨论。
2. 文章要长长长长长长长长长长长长长长长也别太长
我翻了几篇阿里技术公众号里阅读量较高的文章各种话题都有风格差异很大但是有一个共同点文章写得很长。这并不代表文章写了很多字就是好文章背后的真实含义是好文章的内容足够丰富。 内容丰富详实这是一篇好文章的必要条件。还有一个条件是要包含真正有价值的内容不能含太多水分。 提供一个小技巧如果你写了一篇文章但是觉得内容很单薄可以先当成一篇笔记存起来等有了更丰富的积累之后再整理成文章。扩展文章内容的方法并不是添加无意义的空话套话而是根据文章探讨的问题延展开来。 比如说介绍自己解决的一个老大难 Bug可能真正修改的代码并没有几行把过程讲出来也不过寥寥几段。这时候你就可以再分析一下 Bug 存在的原因为什么一直拖到现在再思考一下如何避免这类问题遇到同类 Bug 怎样快速排查。这样自己想问题的角度更全面了文章内容也更丰富了。 比如你想介绍一项自己在学的新技术发现自己写的东西其实就是官方文档的简化版去重之后几乎什么都不剩了。这时候不要再继续抄文档了把自己的思考总结先记下来继续学习技术持续记录新的内容有更全面的了解之后再写文章。
3. 清晰的叙事结构
优秀的技术文章结构一定是清晰的有可能目录就代表了某个技术体系或者代表了解决问题的思路。
优秀的内容 清晰的结构 好文章能把技术问题讲清楚就很考验表达能力这是大部分程序员比较欠缺的。对于技术类文章常见套路也不多我简单介绍两类吧
线性叙事逐步推进适用于介绍排查问题的过程、分享设计思路、介绍项目的迭代进展。结构化叙事层层展开适用于讲规划、做总结、画大图、介绍一整套技术方案。
4. 线性叙事逐步推进
对于这类文章读者是应该按顺序一段一段看的写的时候脑海中模拟读者的视角来写。这类文章的小技巧就是模拟读者视角设定一条主线有节奏的向前推进。和讲故事差不多每一步的推进要有逻辑要保持思路不要断掉。 有时候稍微加点趣味也是不错的比如《Flutter Widget 和 CSS 布局原理 PK》这篇文章目标是分析 Widget 和 CSS 的设计差异我把文章写成一场比赛先介绍参赛选手然后分了 5 个 Round 开始 Battle然后是 LovePeace最后一个 Happy Ending。 另外一篇《记一次完整 C 项目编译成 WebAssembly 的实践》介绍了自己尝试新技术的心路历程先介绍背景再分析需求做拆解然后讲尝试了什么方案遇到了什么坑又继续试其他方案最终是什么结果。读起来比较流畅。
5. 结构化叙事层层展开
除了按顺序看的还有不按顺序看的文章吗有的尤其在专业的技术文章里很常见大部分是“总-分”的结构先讲整体框架再分章节介绍各个部分。 比较常见的是那种总结型的文章比如《平台建设的 7 大问题蚂蚁AI平台实践深度总结》和《救火必备问题排查与系统优化手册》就是翻阅性质的书可以通读一遍也可以只看其中一段之后遇到相关的问题根据目录跳着阅读。 对于文思泉涌的人可以一口气把整篇文章写完。但实际情况是很多时间被碎片化可能还要引用一些专业内容可能需要查资料写文章的过程会被中断。这类文章不是一口气写完的是先搭架子再填充完整的。其实写起来也很简单先想好标题再划分好目录结构再一段一段的填充内容最后再润色一下连接部分。文章可以不按顺序看也可以不按顺序写。 我自己写的《关于浏览器、Weex、Flutter 的比较和思考》这篇文章就是先划分好了目录再一点一点填充的写文章的时间跨度也比较长想起来一点写一点。
线性叙事是个链表结构化叙事是树。提升写作技巧
我初高中的时候比较喜欢看闲书偶尔自己写点东西但是我作文考得并不高这里大言不惭地聊一下怎么写作文吧哈哈哈哈哈。只讲怎么写技术文章并不能提升任何文学功底但说不定能帮你避开一些小坑。
1. 碎片化记录结构化整理
大部分人的问题是不知道该写什么即使已经有足够的积累有明确的话题要写也不知道该如何下笔。这就要靠日常的积累了。
在平时工作的时候可以建个文档库把日常的一些琐碎的想法记录下来随时写随时存。我是用手机的便签 App 随手记东西比较喜欢它的语音转汉字功能工作相关、生活相关随时随地想起任何话题都可以记录下来。 在有了明确话题准备写文章之前先把各种碎片化的记录收集起来形成一份“素材”文档然后梳理文章脉络把素材应用进去。操作起来很简单刚开始的时候会遇到前后不通畅的问题那就不要直接复制素材的内容重新换个表达方式写出来。多练习练习就好了。
2. 刻意练习先写再改
有了素材之后平时可以专门练习写作能力先写一小段话明确的描述一个观点然后不断修改。其实写周报就是一个很好的锻炼机会现在不要求写了自行练习练习把做的事情描述清楚说话的方式简单点不要用太多高大上的词汇。最关键的部分在于写完花五分钟再改一遍读一下是否通顺有没有把问题讲清楚。反复修改才是提升写作技巧的关键。 用周报举例有点奇怪毕竟是邮件类型的东西和写文章差别很大还是不要乱改周报了改自己以前写的文章吧。找一篇自己以前写的内容很不错但是写得不太行的文章重写一遍这个过程既温习了技术又锻炼了写作技巧。不要觉得无聊浪费时间亲测很有效的。
3. 注意排版和语法细节
对于不拘一格的程序员来说写出来的文章没有排版就是家常便饭。不需要追求高级的排版技巧稍微注意一下几个常见的问题就好了。
1正确使用标点符号
大部分的文章里就只有逗号和句号逗号和句号也是看心情随意划分键盘上按到哪个是哪个。其实还有单双引号、顿号、冒号、分号、叹号、破折号、省略号、书名号、中文括号「」【】等等…… 使用方法可以去网上搜这部分我觉得问题很常见就单独多讲了两句。对了中文文章要用全角标点符号尽量不要混用英文标点符号。
2添加多种展现形式可参考 GitHub 的 Markdown 语法
如果全都是普通段落看起来太平可以加上无序列表、有序列表、段落引用、表格等等。行内排版可以加上粗体、斜体、代码标记等偶尔还可以用删除线。 其他还有一些小的建议
区分大标题小标题分配的均匀一些最多不要超过三层。每个章节的长短也尽量均匀一些太长的内容就拆个小标题。重要数据给出明确的数据源扩展信息给出资料连接。中英文混写的时候在中间加一个空格。注意英文的大小写尤其是专业名词的缩写。英文喜欢长句复合从句一层套一层中文追求言简意赅错落有致可以多加标点符号把长句分隔开。写完之后通读一遍尽量少写错别字……
最后一个小技巧多用图片。即使图片里只有文字信息量也远超文字。
然而这篇文章并没有加很多图片因为这并不是一篇技术文章大家在讲技术原理的时候要多用图片一图胜千言
写在最后
最后一个小建议文章写多了就可以逐渐形成自己的风格让所有文章都保持某种共性。
原文链接
本文为阿里云原创内容未经允许不得转载。
