🔥如何寫一篇技術部落格,談談我的看法
前言
只有光頭才能變強。
文字已收錄至我的GitHub精選文章,歡迎Star:https://github.com/ZhongFuCheng3y/3y
我一直推崇學技術可以寫技術部落格去沉澱自己的知識,因為知識點實在是太多太多了,通過自己的部落格可以幫助自己快速回顧自己學過的東西。
我最開始的時候也是隻記筆記,認為自己能看得懂就好。但如果想驗證自己是不是懂了,可以寫成技術部落格。在寫技術部落格的過程中肯定會發現:“這個知識點,我好像還有些沒搞懂”。
從梳理/編寫的過程,自己也會成長不少
有不少的小夥伴曾經問過我:
- “3y你是怎麼記筆記的阿?我一邊看視訊一邊記筆記,顧頭不顧腚的”
- “你寫的部落格都是怎麼思考的阿?我不會寫部落格”
下面來談談我一些觀點(個人/主觀),每個人都有自己的方法論,我的觀點不適用於所有人。
開局一張圖,內容全靠編:
一、如何寫一篇技術部落格
首先,我認為要把自己當做是一個分享者,而讀者是一個小白。然後模擬這個場景:如果你要把你學習到的技術分享給小白,你需要怎麼去做。
按照我的思路,我可能會這樣做:
- 首先,這項技術是什麼你得先告訴他。
- 接著,為什麼要學習這項技術,學習了這項技術有什麼好處。有沒有以前的技術跟這個較為相似的,為什麼我不用以前的,而要學新的。(這一步非常非常重要)
- 然後,這項技術的核心用法是什麼,給出一些小案例,讓小白體驗到這項技術。
- 最後,用這項技術可能會出現什麼問題,官方有沒有提供方案解決,如果沒有,可能的解決方案有哪些。
大白話來說,其實就是:
- 是什麼
- 為什麼
- 怎麼做
一般來說,我會把重點放在 為什麼 ,因為我一直認為學習一門技術一定得知道:為什麼要學。
舉個例子,我當初寫【訊息佇列】的思路:
- 回顧一下什麼是佇列,Java已經支援各種型別的隊列了,跟訊息佇列有什麼不同。
- 為什麼要用訊息佇列,不用行不行?用訊息佇列的好處有哪些
- 用了訊息佇列可能會帶來的問題
如果遇到邏輯可能較為複雜,或者認為讀者會看不太懂的時候,可以畫圖來描述一下,這樣整一篇文章看下來就不會太枯燥。
其實吧,我寫文章都是按自己學習時的思路來寫。如果我在學習時中途某個地方卡住了,我就認為可能讀者在學習的時候也會存在同樣的問題。所以,我就把我的理解給記錄下來,如果有必要就畫圖來講解。
我寫了兩百多篇Java技術部落格,有需要的同學可以關注我的GitHub,歡迎一起學習和交流:https://github.com/ZhongFuCheng3y/3y
二、文章需要有自己的風格
每個人寫出來的部落格都有自己的風格。
比如說有漫畫型的:
比如說有故事型的:
比如說有騷氣型的:
比如說有純乾貨型的:
說了這麼多,其實我想說的是:寫部落格應該要帶有屬於自己的風格。而不是把網上的資料直接複製貼上就完事了,這樣沒有感情,沒有靈魂。(當然了,如果網上可能的確有寫得很好的,可以這麼做,但不可能整一篇都是相同的嘛)
三、關於排版
一篇好的技術文章,它的排版一般不會差。我認為寫技術文章有幾點可以提高一下閱讀體驗:
- 整篇文章不要90%都是程式碼,適當減少程式碼,貼關鍵的部分就好了。(完整的程式碼可以上傳到GitHub)
- 多分段,技術文章可能就相對枯燥,如果將技術的說明擠在一塊,可能閱讀起來沒那麼好的體驗
- 增加圖示說明 or 插入相關的圖片
程式設計師寫文章一般都用Markdown
語法了,使用恰當的話,文章的排版自然也不會太差啦。所以還沒用Markdown
語法的同學可以趕緊用起來,這玩意特好學,從學到用起來就幾分鐘。
- 我當時連簡歷都是
Markdown
語法...
四、關於工具
Markdown編輯器我推薦使用Typora
,無論是在Mac還是在Windows上都很好用。使用Markdown就肯定要考慮一個問題:圖床用哪家?
無論使用哪家圖都有可能會掛,自己搞個圖床可能會安全一些(相對來說會比較麻煩),我自己是使用掘金
的圖床的。而我的文章往往會分發到幾個部落格網站上,像簡書/知乎
這種會單獨將圖片上傳到他們的伺服器上。
所以,從我個人的使用角度而言,並不會擔心圖床會掛問題。如果你將文章只發送到一個平臺中,還是得關注一下圖床是否可能失效的問題。
至於你發哪個平臺,我曾經寫過一篇【程式設計師可以選擇哪些平臺寫技術部落格?】,當時的總結:
- 如果不嫌棄
部落格園
的風格,可以選擇部落格園
。否則建議選擇:掘金
/SegmentFault
。 - 只想管理自己寫過的文章,選擇:
GitHub/GitBook
- 喜歡折騰:
Hexo+GitHub
或者WordPress
簡單的流程圖/思維導圖/..
可以使用ProcessOn
就解決掉了。
最後
有的沒的扯了一些,希望能夠對「有想要寫技術部落格,但無從下手的同學」一些幫助。
本已收錄至我的GitHub精選文章,歡迎Star:https://github.com/ZhongFuCheng3y/3y
樂於輸出乾貨的Java技術公眾號:Java3y。公眾號內有300多篇原創技術文章、海量視訊資源、精美腦圖,關注即可獲取!
非常感謝人才們能看到這裡,如果這個文章寫得還不錯,覺得「三歪」我有點東西的話 求點贊 求關注️ 求分享