寫技術文的三個原則是什麼?

本文章原創首發於公衆號:編程三分鐘編程

我關注了不少技術類的公衆號,看着大佬的公衆號幾千的閱讀量,甚是羨慕,這直接致使了我沒有心情減肥,甚至多吃了一個雞腿。code

要怎麼才能寫出一篇好技術文章,讓讀到的人感到身心舒暢,快速Get到想說的點,我想破了腦殼。基礎

喜歡讀我文章的人多少都和互聯網行業沾邊,像我們這一行加班是常有的,看文章的時間也比較瑣碎:蹲廁所、擠地鐵、吃飯、睡前玩手機。基本就是這四個時間,不是正在作就是在去的路上,有木有?!互聯網

要在有限的幾分鐘裏,讓看的人可以流暢讀完,而且掌握表達的點,是一個頗有難度的事情。引用

我總結了一下,重點有三個:im

  • 精簡
  • 有趣
  • 成體系

精簡

  • 精簡,就是不說廢話,珍惜讀者的時間,把注意力集中在關鍵知識點上,最好在文章開始就能點明主題。
  • 毫不要大段的引用和鋪概念,一旦出現這種狀況,中間也沒夾雜有趣的部分,很容易產生抵觸情緒,這直接影響到閱讀體驗,像我這種爆脾氣,要不是由於窮,直接就把手機摔地上了。

有趣

要讓文章變得有趣起來,可讀性強。技術

  • 發揮出全身上下的幽默細菌,適當寫些段子無傷大雅,甚至能夠加入一些故事情節,讓人耐人尋味。
  • 專業名詞少用,說話越土越好越容易讓人理解。別成天扯那些名詞,又不是在寫論文。
  • 有圖千萬別寫字,有表格用表格,一張圖賽過千言萬語,固然了,能用動圖就更棒了!

固然,有趣是創建在精簡的基礎上,又不是在寫童話書,突出重點,把握好火候。總結

成體系

我看到不少大神技術水平很強,可是喜歡站在本身的角度上說技術,別人基本沒辦法看懂,寫出來的文章也只能本身看。img

在這裏我特別想說,當咱們在看一篇文章或一本書的時候,看個幾行內心面產生一種情緒,「啊,太難了,我好菜啊!」 這不是咱們的錯,而是寫文章的人的問題。時間

寫技術文章不是寫流水賬,要有脈絡,從易到難,按部就班,針對一個新概念要想清楚表達的方式。拆分難的知識點成小塊,最後再聯繫起來。讓人一會兒看懂,成就感滿滿!我比較喜歡問本身:

  • what ? 我要講的點是個什麼東西?
  • why? 這個東東能作點什麼,有什麼用?
  • how? 要怎麼作才能用上(實現)

最後

編程三分鐘從4月27號開始到如今已經有整整五個月了,謝謝你們對小熊(我)的支持,風裏雨裏,我在等你。加油!

image.png

相關文章
相關標籤/搜索