Peter 從事技術寫作有幾年了恭陡，總是會思考的一個問題是递鹉，技術文章到底區(qū)別于官方文檔的價值在哪里？官方文檔的特點是精準詳細郎哭，但是術語多難看懂他匪，而技術文章要做到的就是跟講故事一樣，讓聽眾一遍就懂夸研，輕松快速的學會知識邦蜜。本文的主體內(nèi)容就是我自己的技術寫作的一些心法，跟繪畫有很多相通的地方亥至，因為二者都是表達的藝術悼沈。

要有靈魂

我反對技術文章就是干貨的堆疊，我認為一篇文章最重要的是要有中心姐扮，就像一幅繪畫作品要有靈魂絮供。但是不是說有中心了，就有靈魂了溶握。技術文章的起筆前杯缺，一定是我自己讀了很多資料，頓悟了一個點睡榆，這樣才有了可分享的價值萍肆。如果沒有頓悟，我就不寫文章胀屿，隨便記下幾行筆記就完了塘揣，如果頓悟了多個點，那就寫多篇文章宿崭，不寫到一篇中亲铡。那具體怎么執(zhí)行呢？

首先就是要選定角度葡兑。世界上任何事物都是多面的奖蔓，一個技術其實是可以從很多方面去聊的，如果面面俱到就是文檔讹堤，不是文章了吆鹤。哪個角度能讓讀者去把握這個知識點的最關鍵思想，就非常體現(xiàn)一個作者的品味和見識洲守，也是技術寫作最吸引人的地方疑务。就像畫一幅人像沾凄，首先需要要讓模特擺一個最美的角度。文章一旦選定角度就要全文貫徹下來知允，不然內(nèi)容就寫散了撒蟀，讀者就容易迷惑。

角度有了温鸽，還要選擇焦點保屯。一個技術的知識點肯定很多，也要有取舍的去講嗤朴。要選出最能支撐起靈魂的幾個點來展開文章的內(nèi)容配椭。同時，我想強調(diào)的是雹姊，焦點部分當然要仔細描繪股缸，但是其他局部細節(jié)越簡略越好，原則是離焦點越遠的內(nèi)容越簡略吱雏。就像你去繪畫敦姻，重點是要描繪一個人的憂郁的眼神，那么離眼睛越遠的部分越簡略越好歧杏。如果這幅作品中你發(fā)現(xiàn)這個人頭發(fā)也很漂亮镰惦，然后就細致的畫了頭發(fā)，那就喧賓奪主犬绒，整個畫面看起來會很俗氣旺入。

總之，文章和繪畫一樣就是要有靈魂茵瘾，角度選擇越正確拗秘，文章價值就越大雕旨，而所有焦點的選擇都是服務靈魂的，所有細節(jié)的展開都要圍繞焦點。偏離主題的內(nèi)容越多讹蘑，讀者就會越走神，越難把握作者的意思翠拣。

著力烘托

所以說不必要的細節(jié)越少越好，但是對于重點內(nèi)容就剛好相反然想，一定要講透徹。是陰影讓物體變得更立體，所以重點的突出蛙卤，離不開合理的烘托甜滨。

如果是寫一本書昂验，那么每篇文章的標題都是為了烘托這一章的靈魂和中心。每一章的標題，都要烘托這本書的靈魂奖慌。到一篇文章內(nèi)部，內(nèi)容的展開當然是要烘托本文的中心岛马。一般一篇文章我會拆分成幾個小知識點來講解笛洛，每個知識點盡量是層層遞進的關系撞蜂，每個知識點形成一個二級標題盲镶。每個二級標題內(nèi)部，要提出幾個言之有物的論點或者概念蝌诡，這個就像我們畫畫的時候要有線條溉贿。如果我找不到明確的線條，說明我對這個話題根本沒有理解浦旱，任何概念如果不能用一句話說的很清楚宇色，就證明我還需要繼續(xù)查資料，繼續(xù)理解颁湖。

線條有了宣蠕，下一步就是要渲染∩啵可以用類比來讓晦澀的概念變得好懂抢蚀，例如用一棵樹來類比文件系統(tǒng)結構×蹋可以舉例子讓概念變得生動皿曲，比如說某某項目中就用到了這個知識點。也可以指出常見的理解誤區(qū)吴侦，來限定一下概念的范圍屋休。另外很重要的一點，就是要對定義概念過程中的引出的其他生僻概念再做出適當?shù)慕忉尡溉停ＷC讀者能跟上的思路劫樟。這個地方還是需要特別注意的，講的太少讀者不理解，講的太多心就會跑題叠艳。我自己的做法是奶陈，拓展性的知識點一定要略講，保證正確就可以了附较，不必精確尿瞭。

烘托，是官方文檔上一般沒有的技巧翅睛，但是也正是這些，讓文章凸顯出了高于文檔的價值黑竞。因為根據(jù)信息論原理捕发，信息的冗余越大，那么信息傳遞的效率就越高很魂，因為傳遞過程中的抗噪能力強扎酷。

感情充沛

最后一點我想強調(diào)的就是寫作的時候是要有感情的。表達本身是人和人之間的交流遏匆，所以感情因素就肯定不能忽視法挨。如果作者不能做到真正在意讀者欺税，體會他們的困難和需求虱饿，就肯定寫不出合格的文章村刨。

簡單點說就是要有服務心態(tài)鲫构，不是寫自己想寫的箩祥，而是要寫讓別人有收獲的吊说。文字的目的不是炫耀自己的能力卧秘，而是要讓讀者聽懂绪撵。所以葛超，我自己寫完文章之后暴氏，會仔細的看看全篇的內(nèi)容是不是能夠形成一個一氣呵成的故事，整個的結構如果能環(huán)環(huán)相扣就能很好的鎖定讀者的注意力绣张。文字流淌的過程中也要用各種技巧達成理解上的通暢答渔，比喻，排比侥涵，重復沼撕，轉折，這些文學上的技巧其實都可以用一些独令，保證自己的文字是有溫度的端朵，增加帶入感。所以我寫文章的時候燃箭，會想象有一個好朋友坐在我身邊聽我講這個技術冲呢，于是我會隨時在意，自己有沒有用最自然的語言來表達招狸，有沒有地方跳躍過于急促敬拓，有沒有地方單位內(nèi)容內(nèi)的新概念過于密集邻薯，讓讀者即使能聽懂，也會覺得非常急促和不舒服乘凸。

感情充沛厕诡，人文關懷。引用邏輯思維的羅振宇的一句話：死磕自己营勤，愉悅大家灵嫌。

總結

這篇中談寫作心法。最想表達給大家的中心是：技術文章也是文章葛作，要有清晰的中心寿羞，要有明確的間架結構，也要有行文技巧赂蠢。干貨當然要干绪穆，但是不講究表達技巧的文章，讀者啃起來吃力虱岂，時間也就浪費了玖院。我寫寫作技巧的文章還有一篇，大家搜《我的即興寫作技巧》就可以在簡書上搜到那篇文章第岖，主要講操作步驟难菌，跟本文互補。