搜索

技术博客写作指南

[复制链接]
182|4
 楼主 | 2021-2-20 09:09 | 显示全部楼层 |阅读模式
在开发过程中我们总会碰到这样那样的问题,神奇的是这些问题在网上基本能找到答案,不禁佩服这些大神大婶。
曾几何时,我也想成为他们那样的人,但对于写博客这件事一直敬而远之。
编程本来就够无聊,写作更无聊,这两个无聊的东西加起来真不是稀顶就能解决的,可能得稀后脑勺。
2020让我想通了很多事,比如除了生死其他都是小事,比如要写技术博客。
为什么要写技术博客
  • 技术沉淀

    • 总结归纳:做技术的前几年其实大家的差距并不明显,但是到后来,大概5年左右,有人依然初级程序员,有人已经是架构师了。当然其中有很多因素影响,但很重要的一条是归纳总结的习惯,而写作是归纳总结的有力工具。在写作过程中能梳理思路,查漏补缺,有些想法在编程时并未想到,却在写作中想到。写得多了,知识点会连成线,结成网。
    • 增强记忆:俗话说好记性不如烂笔头,随着年龄的增长,记忆力每况愈下。写作无疑是增强记忆的有效工具。
    • 纠错:人在很多方面认知不足,有时甚至是错的。往往自己察觉不到。但是通过分享,会有些喷子和大神给指出来。这样认知不断更新迭代,就不会出现太多谬误。在正确的认知下会越走越远,越走越开阔。

  • 打造个人IP
    当今世界要说什么最值钱,影响力绝对占据一席之地。网红、明星为什么赚钱,就是因为他们的影响力,各行各业的大神都做自媒体,当然不是为了赚那点流量费,而是在扩大自己的影响力。未来人人都是自明星,中国市场这么大,任何一个小领域都有无限可能,谁的影响力大,谁就是赢家。而写作又是一个扩大影响力的工具。IP比较大的有阮一峰、廖雪峰、王垠等,每个小圈子也都有自己的明星。他们还用愁35岁会不会失业,编程干不动了该怎么办的问题吗?自然不需要。其他行业也都有了自己的网红,期望IT界的网红就是你。
  • 职场加分
    不知道大家有没有发现,有自己的博客去找工作是一个很不错的加分项。最起码说明你是一个善于总结学习的人,面试官可以通过博客更多地了解你,最好是把自己认为非常不错的文章置顶,以此显示自己的水准。

为什么迟迟没写技术博客
很多小伙伴知道写博客的价值,也有过写博客的想法,但是出于种种原因始终没迈开第一步。近期采访了几位小伙伴,我总结了几个突出的原因。
  • 不知道写什么,可以写一个简单的用法、冷门知识、课堂笔记、编程心得、技术分享、项目分享,项目中遇到的问题以及解决方案等。有小伙伴觉得太简单谁都会,没必要写。其实不管你写什么,都有人会,有人不会。再牛的人都有自己的认知短板。
  • 害羞,怕写得不好没人看,写错了被嘲笑、攻击。其实完全没必要,只有不断有读者正面反馈才会不断进步。只要你敢写就有人敢看,只要有人敢批评,咱就敢改正。
  • 追求完美,很多程序员对代码有洁癖,凡事力求完美,但是写作这个事没有完美,何况是刚开始。作家海明威说过:“一切文章的初稿都是狗屎。” 大作家都有这样的心态,我们又有什么放不开的呢?此时完成比完美更重要。

如何写技术博客
  • 明确写作目的和受众
    首先要明确写作目的,受众人群。也就是给博文定调,是轻松幽默、力求详尽,还是严肃认真、专业概括,亦或者其他风格。
  • 写什么

    • 自己看,就是随笔,个人笔记。可以随笔写,甚至可以是一句话,一张图。完全可以是自嗨文。
      自嗨文:网络流行词,就是调子很高,辞藻华丽,但没站在用户立场上写的文章。
    • 技术分享,这时就要考虑全面,不能写成自嗨文,要有一定的套路,要明确受众是哪些群体,是小白,还是高手,或者是领导。根据受众的喜好和自己的能力圈适当发挥。
      ——提出问题->分析问题->解决问题->总结经验,技术问题分享。
      ——摘要->简介->分支主题->总结,一般技术分享。
      ——是什么-原理-背景>解决了什么问题->基本操作->同类对比->总结 ,适合新技术分享。
    • 约稿,一般情况甲方都会给一定的格式和要求,再结合技术分享的经验成稿。

  • 怎么写


    • 制作思维导图
      有时写着写着就写不下去了。如果提前搭好框架,做成思维导图,就会轻松很多,不至于写到一半卡壳。技术博客一般结构都是总-分-总。
    • 参考文献
      在写作过程中会遇到认知盲区,或者有更权威的表达,我们可以引用,引用最好权威,注意要标明出处。建议引用占博文的比例不超过10%,太多就成了抄袭。如果实在不知道从何入手,如何写,也可以参考其他同类文章,有时完成一篇博文要参考几篇甚至几十篇文章。有些诚实的小伙伴会说这不成了抄袭吗? 抄袭和借鉴还是有本质区别,况且小白入手都是模仿,学习同行。慢慢就会有自己的风格和套路。
    • 排版
      markdown,几乎是所有博客网站的标配。

去哪写
现在写技术博客的地方还是比较多,大家可以根据自己的喜好选择合适的平台发布自己的文章,也可以多平台发送,分布式,扩大影响力。
选择平台的因素是:

    • SEO
    • 影响力
    • 自己喜好

下面列举几个比较主流的平台:
  • csdn:这是国内最老牌的博客论坛,大家比较熟悉。
    优点:seo做得很好,用户量大。
    缺点:很臃肿,广告满天飞,对新人不是很友好,很难脱颖而出。
  • 博客园:这是第二老牌的博客网站了。
    优点:同样是seo比较好,用户量大。
    缺点:写作体验太差,像上个世纪的东西,不过它可以自定义博客样式,美化博客。
  • 掘金,平台比较新。
    优点:比较清爽,写作体验很好,可以写自己的小册子赚钱。
    缺点:seo做得太差,搜索引擎基本看不到掘金的文章,很多软广告,带有面试字样的标题都是送资料引流的。
  • v2ex,技术氛围也不错,就是个人不太喜欢它的界面风格。
  • 思否,更多地专注于技术问答的平台。回答质量也很高。
  • 腾讯云社区,很多大牛,不太适合新人。写一段时间后可以去里面同台竞技。
  • 阿里云云栖社区,同腾讯云社区。
  • 简书,不是专门的技术网站,但也支持markdown,seo权重高。
  • 知乎,更专注于问答,seo权重高,适合引流。
  • 公众号,没有门槛,原则上要把自己的粉丝引到公众号上来,值得长期经营。
  • 独立建站,就是比较麻烦,但是更容易掌控,自己的地方自己说了算。一些大牛都有自己的博客网站。比如:廖雪峰、阮一峰、轮子哥,知乎“温赵轮”三大软狗之一 、王垠等。

总结写博客是百利无一害的事情,只要坚持,一定会有意想不到的收获。不问西东,干就完了。

使用特权

评论回复

评论

dirtwillfly 2021-2-21 15:15 回复TA
总结的很好 

相关帖子

| 2021-2-23 13:57 | 显示全部楼层
总结写博客是百利无一害的事情,只要坚持,一定会有意想不到的收获。不问西东,干就完了。

很到位。哈哈。

使用特权

评论回复
| 2021-2-23 14:59 | 显示全部楼层
以前我也常写,后来慢慢淡漠了 找一个好的平台 长久不衰很不容易

使用特权

评论回复
| 2021-2-24 08:24 | 显示全部楼层
总结一下,对自己也是一个提高。
就是要注意一点:有些公司的know-how的东西,要注意保密。

使用特权

评论回复
扫描二维码,随时随地手机跟帖
您需要登录后才可以回帖 登录 | 注册

本版积分规则

我要发帖 我要提问 投诉建议 申请版主

快速回复

您需要登录后才可以回帖
登录 | 注册
高级模式

论坛热帖

关闭

热门推荐上一条 /7 下一条

在线客服 快速回复 返回顶部 返回列表