如何寫出別人看得懂的技術文章?

2022-01-10 13:34:48 字數 2980 閱讀 6915

說起寫部落格,我從 2014 年畢業開始就有寫部落格的習慣,只不過當時寫的博文更多是像記筆記,讀者看下來迷迷糊糊的。我開始真正意義上的寫部落格應該是從 2017 年 8 月 23 日開始。在這一天我發表了我的第一篇博文:《圖靈機快速入門教程》,講的是圖靈機的基本原理,以及科學家如何利用圖靈機建造起計算機的大廈。或許因為文章寫得還不錯,所以首日閱讀量不再是個位數。從那時候開始,我便保持一周一更的頻率。雖然中間有過間斷,但還是堅持下來了。

在這一年的寫作時間裡,我也迷茫過、困惑過,也好幾次被「下架」過,但還好堅持寫下來了。除了寫作,我也一遍思考的運營思路,希望能與平台實現互惠共贏。從一開始的個位數閱讀量,到後來穩定到幾百的閱讀量,到最終能穩定進入首頁的流量池**。經過了一段時間的驗證,我覺得我對運營的一些思路得到了有效的驗證,所以在這裡分享我的一些經驗給那些想寫好文章的朋友。

對於我來說,我收穫的是技術交流以及技術實力的提公升。

通過寫技術文章,我把之前看似掌握的知識再次深入研究,再次加深了對知識的理解。而當文章發表之後,看你文章的人又會提出各種疑問,這些疑問又促使你去思考。有好多次我以為自己對某個技術的理解是正確的,但當讀者提出疑問時,我才意識到自己理解錯了。所以對於作者的我,寫作的價值是技術實力的提公升。

那對於讀者呢,他們收穫了什麼,這是乙個很重要的問題。如果你的文章無法給讀者帶來價值,那麼讀者久而久之便會遠離你。只有你的文章對讀者是有價值的,讀者才願意閱讀你的文章,也才願意給你更多的反饋,作為作者的你也才會更有動力去寫作。

對於讀者來說,讀者收穫的是深入淺出的技術見解。

通過閱讀我的文章,讀者能夠通過我簡單的語言,理解了之前無法理解的技術,學到了更多的東西,提公升了自我。知識的提公升本身就是一件很有價值的東西,你創造了這篇文章,這篇文章又影響了無數的人,讓無數人獲得了知識。獲得知識本身,就是一種價值。

前面說過要寫對讀者有價值的文章,那究竟什麼才是對讀者有價值的呢?

所以在上,適合寫技術類文章,而不是其他。

既然決定寫技術類文章了,那技術類文章應該如何寫呢?許多人寫的部落格其實都不算部落格,最多就是自己的學習筆記,這樣的文章對於讀者來說基本上沒什麼意義。甚至對於作者來說,可能過幾個月後再來看,他自己也看不懂了。因此寫技術類文章,最重要的就是要讓讀者看懂,要讓讀者明白你要表達的意思。只有當讀者明白你的意思之後,你的文章才能給讀者創造價值。

那問題來了,如何寫出讀者看得懂的文章?

其實這個問題很簡單,但又一點都不簡單。它簡單之處在於,如果你是乙個同理心很強的人,這個問題就很簡單。如果你缺乏同理心,即不懂得站在讀者的角度思考問題,那麼這個問題就很難。可能上面說得很玄乎,但沒關係,我說得簡單一點,同理心其實就是把你自己當成是讀者,問問自己:這文章你能看得懂嗎?懂得站在讀者的角度看文章是非常重要的,只有學會了這個方法,你才知道自己的文章寫得好不好。

上面說的說的都是理論的部分,下面說說實踐的部分。

要寫出讀者看得懂的文章,可以採用故事式的寫作方式。所謂故事式的寫作方式就是交待好故事的背景,之後再一步步深入**問題,最後給出問題的解決方案。帶著讀者一起深入到問題中去,帶著讀者一起思考,最後再把讀者帶出來,就像做乙個全包的旅遊保姆一樣。千萬不要帶到一半突然跑路了,這時候讀者是會很憤怒的。

我舉乙個例子,我在寫《藏在正規表示式裡的陷阱》之時,首先我交待了這個「陷阱」的背景(機器100%cpu異常),之後簡略交待了如何定位問題(dump出線程資訊),最後針對回溯問題做由淺到深的深入講解。對於這類問題,最重要的還是把問題背景交待清楚,如果讀者連問題都不清楚,那麼你後面的分析就完全沒有意義。

對於不同型別的技術文章,敘述方式會略有不同,但理論的部分卻是一致的。時刻站在讀者的角度上思考問題,想想讀者能不能看懂,這是最重要的事情。

說了這麼多,其實都是紙上談兵,要真正獲得寫作技能的提公升,還是需要開始寫起來,只有開始了才有進步的可能。對於剛剛開始的朋友,我建議你可以從模仿開始。看看那些寫得好的文章,它們為什麼寫得好,去分析、去思考,最後模仿它們的寫作方式。在模仿過程中,你會收穫很多東西,與此同時你的寫作技能也在不斷提公升。

首頁資訊流是我們日常瀏覽文章的主要區域,但其時效性比較高,隨著時間的流逝,你的文章會淹沒在文章流中。

對於廣大的作者來說,首頁資訊流是乙個日常的、成本最低的獲取流量入口。只要你的文章是原創技術文章,並且達到了一定的篇幅,那麼在發表文章的時候勾選「發布至首頁」按鈕,那麼文章就會出現在首頁資訊流中。

而發布文章最好的時機是在工作日的早晨8點-10點之間,這個時間剛好人都準備上班,上班之前都會稍微瀏覽一下技術文章。只要你的文章標題起得好,內容也不錯,那麼文章收穫幾百的閱讀量是非常輕鬆的。

對於剛剛寫作的朋友來說,其實最重要的不是文章質量有多高,又或者運營技巧有多好,最重要的還是能長久地堅持去寫東西。要想長久地堅持做一件事情,那就必須形成正向反饋,最終形成良性迴圈。作者與讀者的關係更是如此!

雖然我也知道我的呼籲不一定有用,甚至會引來許多人的嘲諷,但我還是希望自己能為不為利益去做點什麼東西,即使這份力量很薄弱,但這也是乙份支援。

作為技術寫作者的我,其實特別想去改變這個現象,但很多時候又覺得自己實力不夠。但通過這一年的寫作和反饋,我覺得自己可以嘗試著去做這麼一件事情了。雖然我也不算是幾千粉絲的大v,但對於這件事情來說,重要的不是你有多大影響力,而是你到底有多想做這件事情。無論你是剛剛還在大學念書的學生,還是已經工作一段時間的碼農朋友,只要你希望通過寫作來分享自己的技術見解,我都歡迎你與我一起交流。我在時間允許的情況下,可以對你寫的文章給出一些建議。

看了這麼久,去右下角點個推薦再走唄。

胖虎都看得懂的CSS入門

層疊樣式表 英語 cascading style sheets,簡寫css 又稱串樣式列表 級聯樣式表 串接樣式表 層疊樣式表 階層式樣式表,一種用來為結構化文件 如html文件或xml應用 新增樣式 字型 間距和顏色等 的計算機語言,由w3c定義和維護。目前最新版本是css2.1,為w3c的推薦標...

看得懂的海明校驗碼

例如傳送過來的資料是 1010 k表示校驗碼的位數 n表示例如1010表示n 4 第一步 通過公式找到k值 2 k n k 1 k 3 第二步 給1010每乙個位標上位置 1 0 1 0 d4 d3 d2 d1 第三步 找到校驗碼插入的位置 已知k 3,有三位校驗碼 p1 2 i 1 1 p2 2 ...

小孩都看得懂的基尼不純度

全文共1343字,16幅圖,預計閱讀時間8分鐘。本文是 小孩都看得懂 系列的第十一篇,本系列的特點是極少公式,沒有 只有圖畫,只有故事。內容不長,碎片時間完全可以看完,但我背後付出的心血卻不少。喜歡就好!小孩都看得懂的神經網路 小孩都看得懂的推薦系統 小孩都看得懂的逐步提公升 小孩都看得懂的聚類 小...