如何編寫一篇的技術BLOG

2021-03-02 工程師的自我修養之路
背景

最近和組裡幾位同學聊寫技術BLOG的事情,聽到最多的是:我不知道寫什麼(主題)、不知道怎麼寫(內容結構)、寫blog對我有什麼好處(投入產出)。基於我個人近幾年寫博客的一些經驗和收穫,聊聊如何寫一篇高質量(主題明確、結構清晰、乾貨滿滿)的技術BLOG。


要不要寫技術BLOG

首先明確一點:做技術的同學要不要寫技術BLOG?

我個人的感受:不寫沒什麼壞處,堅持寫,會有意想不到的收穫!


寫技術BLOG的好處

    上面說到堅持寫技術BLOG會有意想不到的收穫,說說我自己堅持寫了四年BLOG,有哪些收穫。我們現在面對的是五花八門的技術體系和越來越快的迭代速度,相信大家或多或少會有下面幾種操作:

1)咦,這個文章不錯,對我挺有用的,收藏先;

2)哦豁,這個視頻不錯,先存個雲盤,回頭看;

3)哇,這個大佬推薦的書挺適合我,買了再說;

然後呢,可能這篇文章、這個視頻、這本書,躺在角落裡,都被時間的灰塵掩蓋了,本人也忘記有這件事了。我個人覺得,無論是寫BlOG,記筆記,便箋,還是收藏這些方式,都是一種累積的過程,這是一種輸入。但是,有輸入沒輸出豈不是閉門造車?寫BLOG能帶給我們的,主要有下面這些:

知識沉澱

知識沉澱不言而喻,遇到對自己有幫助的、值得回頭品味的,快速記錄。好記性不如爛筆頭,日積月累,你會發現你有很多碎片化的知識沉澱。碎片化知識沉澱如何輸出?寫BLOG是很好的方式。

正向反饋

寫了技術BLOG,就放心大膽的發布,讓更多的人看到,看到了才會有評論,通過別人的視角,發現自己的不足,在後面的BLOG編寫中,不斷提升,形成一個正向的反饋循環。

梳理思路

寫BLOG的過程,實際上是一個再次學習和梳理思路的過程。

如何將碎片化的知識變成體系化的輸出?主題怎麼寫?如何構建知識框架?碎片化知識有錯誤,如何排查?在這個過程中,其實也是重新整理思路的過程。

我們看待問題和碎片化知識的角度,會從這個我好像知道&看過不斷演變成這個相關的我寫過,遇到過什麼問題,我是如何解決的,類似的問題可以這樣這樣來處理

品牌建設

我個人寫了四年多博客,從剛開始的無人問津,到現在幾千關注、百萬閱讀量,也漸漸的在小範圍內樹立了個人品牌。寫的博客可以通過公眾號來對外輸出,或者一些技術大會合作,引流,還可以將自己的沉澱輸出寫一本書。當我們面試跳槽,演講分享時,個人品牌就自然會帶來不一樣的影響力。

斜槓收入

斜槓收入這裡,以我個人為例。我將自己寫的博客,挑了些比較滿意的,發布到個人公眾號。有訂閱有關注後,接了些商業推廣,只負責轉發一遍,就有幾百上千的收入。公眾號現在還能設置付費閱讀,我自己也賺了一丟丟。當然,偶爾也會有點私活,這個看個人選擇。


編寫高質量的BLOG

關於寫博客的好處說了一大堆,終於到這篇博客的主題了:如何編寫高質量的BLOG?

主題明確

從我個人的寫作和閱讀經驗來看,主題一定要明確。比如:

我目前主要負責性能測試&全鏈路壓測相關,我想寫一篇介紹全鏈路壓測相關的博客。那我的主題可以是這樣:

毒在全鏈路壓測的第一次實踐

得物(毒)全鏈路壓測探索實踐之路

得物(毒)生產全鏈路壓測實踐之道

或者說,我是主要負責業務測試的,那麼我要寫的主題,可以是這樣:

XXX項目介紹

XXX項目重構實踐

如果我是開發,最近學習實踐了服務通信框架相關知識,整理了不少筆記,比如這樣:

我的主題怎麼定義呢?可以這樣寫:

服務通信框架學習筆記

服務通信框架實踐總結

服務通信框架基礎知識總結

服務通信框架在我司的實踐

結構清晰

確定好主題,正文如何編寫呢?我的建議是:先梳理思路,根據主題將正文的核心部分羅列出來。有個比較通用的結構模板,如下(僅供參考):

乾貨滿滿

主題明確,結構梳理清楚後,剩下的就是不斷的填充內容和review調整了。一般來說,這樣基本不會偏離主題。當然,我們寫博客的最終目的,還是知識沉澱——梳理思路——自我成長。而非為了完成任務或者其他因素。


總結

最後,回顧本篇BLOG的主題、結構和內容,大體沒有偏離我們要講述的核心。

至於如何輸出真正的高質量的BLOG,訣竅其實在這裡:勤學習、多記錄、堅持輸出。


相關焦點

  • 我是如何寫好一篇技術博客的
    今天我來和同學們分享一下,如何去寫好一篇技術文章。目錄在我們學習了某項技術,並有了使用的經驗之後,就可以著手來一篇,它通常面向的是此類技術的小白。總結(總):這個技術使用的優缺點,在具體的實踐中如何幫助我們。
  • 權威解讀:什麼是博客(BLOG)
    Peter Merholz由此將blog變成動詞,後來更衍生出blogging、blogger或者I blog、Blogsphere(博客世界)等的說法。有人寫道:「blog的確存在這種現象。許多新聞媒體(比方說華盛頓郵報)為了強調blog驚人崛起的現象,常用blogger.com的使用人數(目前為750,000)來作指針,而不管其內容特質是否符合blog。事實上,我們也很容易認為使用moveable type、greymatter、b2、blogger、pmachine等等weblog工具都是blog了。
  • 如何編寫簡潔美觀的Python代碼
    編寫代碼是數據科學家或分析師角色的一部分。另一方面,編寫漂亮整潔的Python代碼完全是另一回事。作為一個精通分析或數據科學領域(甚至軟體開發)的程式設計師,這很可能會改變你的形象。那麼,我們如何編寫這種所謂漂亮的Python代碼呢?
  • 這是一篇關於程序在線升級的乾貨文章!
    這是網上看到的一篇關於程序在線升級的乾貨文章,轉與大家一起學習。
  • 輪椅MDR CE技術文件符合性聲明如何編寫更新?
    面對歐盟法規的換版對技術文件帶來的影響有哪些?2.1 Device Description 產品描述2.1.1 MDD法規對技術文件的要求:1)本技術文檔所涵蓋的產品和及所有型號。2)MDR歐代同責2.3 Essential Requirement 基本要求2.3.1 MDD法規對技術文件的要求:1)基本要求檢查表,必須在「相關支持文件/報告」列中說明如何滿足基本要求(寫明證據文件或報告的編號)。2)對於認為不適用的要求,應說明理由。
  • 使用JavaScript編寫MapReduce程序
    書中分別介紹了如何使用 Ruby 和 Python 結合 Hadoop Streaming 進行開發,但是並沒有介紹如何使用JavaScript編寫MapReduce程序,所有本文就是為了解決這個。我們先來分析 Hadoop Streaming 的原理,如下:mapper 和 reducer 會從標準輸入中讀取用戶數據,一行一行處理後發送給標準輸出。
  • blog的來歷及其派生詞
    Blog詞源   「Online Etymology Dictionary」blog,1998, short for weblog (which is attested from 1994, though not in the sense "onlinejournal"), from (World Wide)
  • 手把手教你用Python編寫窗口程序,實現PDF轉圖片功能
    wxFormBuilder的使用方法參見:http://blog.sina.com.cn/s/blog_78391af20102yb10.html設計好窗口後,在Python頁面全選代碼,並粘貼到pycharm新建的工程下面,命名為Form.py2.在pycharm中導入PyMuPDF這個輪子,方法參見:用pip及pycharm無法直接安裝pymupdf輪子的問題
  • 編寫Shellcode:尋找EIP/RIP
    本文為看雪論壇優秀文章看雪論壇作者ID:sudozhange當學習主動安全認證專家(OSCE)(連結:https://www.offensive-security.com/ctp-osce/)認證時,我花費了大量的時間用於研究如何編寫自定義
  • 分享一篇關於程序在線升級的乾貨文章
    這是網上看到的一篇關於程序在線升級的乾貨文章
  • 如何編寫shellcode查找EIP & RIP
    我在學習OSCE認證時,花費了大量時間研究如何編寫自定義shellcode。這是我打算發布的一系列博客文章中的第一篇,其中將詳細介紹我在此過程中學到的一些技術。這篇博客文章的重點將是描述如何找到EIP / RIP,以及找到它可以做什麼。OSCE將精力集中在32位系統上,作為我繼續學習的一部分,我將研究和記錄適用於64位系統的方法。
  • Wordpress轉Zblog 2.0的詳細教程
    wordpress轉zblog 2.0的插件WPImport的推出,大大增加了很多發燒博友們選擇博客程序的空間。比如之前功能還不夠完善的zblog1.8無法承載很多博友們的要求,讓這部分博友選擇了wordpress,但wordpress的易用性對比zblog來講是有點打折扣的(純屬個人觀點,php玩得好的朋友當然不會存在這樣的情況,所以希望你們理解不懂PHP博友的取向,記得當初我第一次安裝wordpress進入後臺使用的時候還真不知道如何下手,對新手來講感覺太高深了,,當然現在略知一點點)。
  • 如何編寫軟體的操作手冊?
    企業上ERP系統的時候,顧問通常需要編寫操作手冊給用戶,當然最好是由關鍵用戶來給最終用戶編寫操作手冊,那樣才能保證知識的轉移到位。但是經常有顧問覺得自己已經用盡洪荒之力而且寫得很細,但是客戶還是表示看不懂。
  • 教師面試教案編寫技巧:如何在短時間內設計一篇高質量教案
    一篇好的教案,已經意味著試講成功了一半。有些同學也許會認為:作為師範類的學生,書寫教案不是一門必備的技能嗎,為什麼還要來探討「寫教案」的這個話題呢?今天我們就一起來探討一下,如何在短時間以內,寫出一遍高質量的教案。技巧一:省去教案中不必要的部分由於教師面試時,備考時間有限。
  • 如何正確編寫Excel格式的需求文檔?
    如何編寫Excel格式的需求文檔?作者根據自身經驗,並結合案例分享了相關經驗,希望對你有用。之前參加枯葉講師的公開課,提到了Excel需求文檔的優勢,剛好目前工作中也是通過Excel來編寫需求文檔,於是總結如下通過Excel來編寫需求文檔的經驗和技巧。
  • 如何編寫一個 Webpack Plugin
    前言上次寫了 如何編寫一個 Webpack Loader,今天來說說如何編寫一個 Webpack Plugin。webpack 內部執行流程一次完整的 webpack 打包大致是這樣的過程:將命令行參數與 webpack 配置文件 合併、解析得到參數對象。
  • 教你如何編寫第一個爬蟲
    但是很對人覺得Python爬蟲是違法的行為,也在懷疑自己到底要不要學爬蟲,之前有一篇文章特別火,就是《 只因寫了一段爬蟲,公司200多人被抓!》,文章裡寫了因為一名技術人員因爬取數據被抓,那麼爬蟲真的違法嗎?今天我們來探索一下。目前網際網路世界針對爬蟲這一塊已經通過自身的協議建立起一定的道德規範(Robots協議),但法律部分還在建立和完善中。那麼Robots協議是什麼呢?
  • Go技術日報(2021-02-16)——解密 defer 原理,究竟背著程序猿做了多少事情?
    3.搭一個 K8s 集群二、#公眾號:亞軍進化史1.Go 技術日報(2021-02-15)——Rust 的第一印象三、#公眾號:Go 招聘2021-02-16 1.在瀏覽器中部署 Go HTTP 伺服器2.在 Go 中開發可用於生產的 REST API [1]3.內聯函數和編譯器對 Go 代碼的優化4.使用 Go 語言編寫的使用
  • 程式設計師如何自我學習?阿里資深技術專家這樣做
    並非單靠看一篇文章就能明白原理。個人強烈推薦:https://www.safaribooksonline.com/ Safari應該是出版社聯盟,IT類圖書基本都能找到。兩個小問題是:需要收費,一年大概400刀;圖書都是英文的。
  • 新授課教案編寫要點
    常見課型有新授課、習題課、複習課、實驗課等,常見課型教案編寫的要點在教師資格考試中是重要的考點,主要以單選題和教學設計題的形式出現。同學們要深入理解常見課型所對應的教案編寫的要點並能夠寫出相應課型的教案,接下來對新授課教案編寫的要點進行詳細的講解。一、教案編寫的要點新授課教案編寫要抓好教學各環節的過渡與銜接,並寫明有效措施,便於突破難點。