Peter 從事技術寫作有幾年了，總是會思考的一個問題是颤绕，技術文章到底區(qū)別于官方文檔的價值在哪里捕虽？官方文檔的特點是精準詳細慨丐，但是術語多難看懂，而技術文章要做到的就是跟講故事一樣泄私，讓聽眾一遍就懂房揭，輕松快速的學會知識。本文的主體內容就是我自己的技術寫作的一些心法晌端，跟繪畫有很多相通的地方捅暴，因為二者都是表達的藝術。
要有靈魂
我反對技術文章就是干貨的堆疊咧纠，我認為一篇文章最重要的是要有中心蓬痒，就像一幅繪畫作品要有靈魂。但是不是說有中心了漆羔，就有靈魂了梧奢。技術文章的起筆前，一定是我自己讀了很多資料演痒，頓悟了一個點粹断，這樣才有了可分享的價值。如果沒有頓悟嫡霞，我就不寫文章，隨便記下幾行筆記就完了希柿，如果頓悟了多個點诊沪，那就寫多篇文章，不寫到一篇中曾撤。那具體怎么執(zhí)行呢端姚？
首先就是要選定角度。世界上任何事物都是多面的挤悉，一個技術其實是可以從很多方面去聊的渐裸，如果面面俱到就是文檔，不是文章了。哪個角度能讓讀者去把握這個知識點的最關鍵思想昏鹃，就非常體現(xiàn)一個作者的品味和見識尚氛，也是技術寫作最吸引人的地方。就像畫一幅人像洞渤，首先需要要讓模特擺一個最美的角度阅嘶。文章一旦選定角度就要全文貫徹下來，不然內容就寫散了载迄，讀者就容易迷惑讯柔。
角度有了，還要選擇焦點护昧。一個技術的知識點肯定很多魂迄，也要有取舍的去講剑勾。要選出最能支撐起靈魂的幾個點來展開文章的內容渊胸。同時，我想強調的是吕晌，焦點部分當然要仔細描繪怠晴，但是其他局部細節(jié)越簡略越好遥金，原則是離焦點越遠的內容越簡略。就像你去繪畫蒜田，重點是要描繪一個人的憂郁的眼神稿械，那么離眼睛越遠的部分越簡略越好。如果這幅作品中你發(fā)現(xiàn)這個人頭發(fā)也很漂亮冲粤，然后就細致的畫了頭發(fā)美莫，那就喧賓奪主，整個畫面看起來會很俗氣梯捕。
總之厢呵，文章和繪畫一樣就是要有靈魂，角度選擇越正確傀顾，文章價值就越大襟铭，而所有焦點的選擇都是服務靈魂的，所有細節(jié)的展開都要圍繞焦點短曾。偏離主題的內容越多寒砖，讀者就會越走神，越難把握作者的意思嫉拐。
著力烘托
所以說不必要的細節(jié)越少越好哩都，但是對于重點內容就剛好相反，一定要講透徹婉徘。是陰影讓物體變得更立體漠嵌，所以重點的突出咐汞，離不開合理的烘托。
如果是寫一本書儒鹿，那么每篇文章的標題都是為了烘托這一章的靈魂和中心化撕。每一章的標題，都要烘托這本書的靈魂挺身。到一篇文章內部侯谁，內容的展開當然是要烘托本文的中心。一般一篇文章我會拆分成幾個小知識點來講解章钾，每個知識點盡量是層層遞進的關系墙贱，每個知識點形成一個二級標題。每個二級標題內部贱傀，要提出幾個言之有物的論點或者概念惨撇，這個就像我們畫畫的時候要有線條。如果我找不到明確的線條府寒，說明我對這個話題根本沒有理解魁衙，任何概念如果不能用一句話說的很清楚，就證明我還需要繼續(xù)查資料株搔，繼續(xù)理解剖淀。
線條有了，下一步就是要渲染纤房∽莞簦可以用類比來讓晦澀的概念變得好懂，例如用一棵樹來類比文件系統(tǒng)結構炮姨“乒危可以舉例子讓概念變得生動，比如說某某項目中就用到了這個知識點舒岸。也可以指出常見的理解誤區(qū)绅作，來限定一下概念的范圍。另外很重要的一點蛾派，就是要對定義概念過程中的引出的其他生僻概念再做出適當?shù)慕忉尪砣希ＷC讀者能跟上的思路。這個地方還是需要特別注意的洪乍，講的太少讀者不理解眯杏，講的太多心就會跑題。我自己的做法是典尾，拓展性的知識點一定要略講，保證正確就可以了糊探，不必精確钾埂。
烘托河闰，是官方文檔上一般沒有的技巧，但是也正是這些褥紫，讓文章凸顯出了高于文檔的價值姜性。
感情充沛
最后一點我想強調的就是寫作的時候是要有感情的。表達本身是人和人之間的交流髓考，所以感情因素就肯定不能忽視部念。如果作者不能做到真正在意讀者，體會他們的困難和需求氨菇，就肯定寫不出合格的文章儡炼。
簡單點說就是要有服務心態(tài)，不是寫自己想寫的查蓉，而是要寫讓別人有收獲的乌询。文字的目的不是炫耀自己的能力，而是要讓讀者聽懂豌研。所以妹田，我自己寫完文章之后，會仔細的看看全篇的內容是不是能夠形成一個一氣呵成的故事鹃共，整個的結構如果能環(huán)環(huán)相扣就能很好的鎖定讀者的注意力鬼佣。文字流淌的過程中也要用各種技巧達成理解上的通暢，比喻霜浴，排比晶衷，重復，轉折坷随，這些文學上的技巧其實都可以用一些房铭，保證自己的文字是有溫度的，增加帶入感温眉。所以我寫文章的時候缸匪，會想象有一個好朋友坐在我身邊聽我講這個技術，于是我會隨時在意类溢，自己有沒有用最自然的語言來表達凌蔬，有沒有地方跳躍過于急促，有沒有地方單位內容內的新概念過于密集闯冷，讓讀者即使能聽懂砂心，也會覺得非常急促和不舒服。
感情充沛蛇耀，人文關懷辩诞。引用邏輯思維的羅振宇的一句話：死磕自己，愉悅大家纺涤。
總結
這篇中談寫作心法译暂。最想表達給大家的中心是：技術文章也是文章抠忘，要有清晰的中心，要有明確的間架結構外永，也要有行文技巧崎脉。干貨當然要干，但是不講究表達技巧的文章伯顶，讀者啃起來吃力囚灼，時間也就浪費了。我寫寫作技巧的文章還有一篇祭衩，大家搜《我的即興寫作技巧》就可以在簡書上搜到那篇文章灶体，主要講操作步驟，跟本文互補汪厨。
