[譯]如何撰寫精彩的技術博客文章

--- 從創意到精緻結果的五個步驟

原文連接：medium.freecodecamp.org/how-to-writ…

我已經在開源社區工做了近 5 年，創建和推廣包括 Meteor 和 Apollo 在內的開發者工具。在那個時候，我發現博客是傳播思想的最有效方式之一。

寫博文不像視頻或會談須要花費很長時間來準備，是個受衆廣且很容易完成的。我我的也從寫做中得到了不少好處：它幫助我組織了本身的想法，向人們傳播了我喜歡的技術，還讓人們知道了我。

2014 年我發佈了第一篇博文，到如今我已經在 Medium 上寫了 68 篇文章了，其中一些文章有超過 50k 的瀏覽次數和 1000 個粉絲。我還爲個人朋友和同事編輯過不少帖子。通過那段時間的鍛鍊，我已經有了一個把概念實現到發佈成文的策略。

在本文中，咱們將介紹撰寫帖子的過程的五個主要步驟：

• 全力找一個好主題

• 明確目標和受衆

• 有一個好的開頭結尾而且內容翔實

• 得到反饋並進行迭代

• 添加最後潤色：包裝，發佈和宣傳

讓咱們進入第一步吧！

1.全力找一個好主題

你須要先有一些想法才能開始寫做。 那些想要開始寫博客的人跟我說，沒有想法一般是他們的主要阻礙問題。

最簡單的策略是寫你所知道的。 若是你花了不少時間學習某些東西，而且你認爲你能夠在幾分鐘內解釋它，那麼你將爲讀者提供不少價值。

另外一個想法是寫一個某個區域沒有的內容。 例如，目前關於如何申請技術會議的帖子很少，所以有關這方面的內容可填補社區空白。

如下是可使用的一些特定類型的帖子。 示例來自 Apollo 博客上與 GraphQL 相關的帖子：

1.實現特定目標的分步指南：「使用 FlatList 在 React Native 中構建一個出色的可滾動列表」或「使用 Apollo 和 Recompose 簡化您的 React 組件」。 這些對於那些想要快速作一個 demo 的讀者來講很是棒。

2.對特定主題的深刻調查：「使用 GraphQL 中的可空性」或「GraphQL 查詢的剖析」。 若是你的目標受衆是對此感興趣而且想要用一杯咖啡的時間來了解更多知識的話，這些內容會很是有用。

3.圍繞一個經常使用主題較爲有用的清單：「調用 GraphQL API 的 4 種簡單方法」或「靜態 GraphQL 查詢的 5 種好處」。 這是一個有趣，輕量級的閱讀，由於你沒必要閱讀總體，是很容易利用碎片時間來完成的。

還有一些共同關注的問題，如今來打消這些疑慮：

1.關於這個話題已經被討論過了。 不要擔憂。 即便這個想法之前被寫過，你也能夠用本身的視角，來闡述在你這種特定環境下的不一樣作法。

2.個人想法不夠有趣。 個人不少朋友和同事都不寫，由於他們擔憂他們的結論可能很無聊或顯而易見。 這很正常啊！ 若是你是某一方面的專家，那麼理所固然你所寫的結論對你來講會很無聊。關鍵是你的觀衆還不知道那些東西呢。

即便說了這麼多，在最後也很難預測什麼樣的主題能成爲一個精彩（火）的文章，哪樣的不會，而且每每是堅持寫或換個文章，而不是一個精彩的主題。 個人主要建議是嘗試寫幾個不一樣的東西，看看哪些有用。

燈泡 - 一般用來表明想法

2.明確目標和受衆

既然你已瞭解本身的主題，那麼須要爲本身的帖子提供受衆羣體和目標。 誰會閱讀它，他們將從中得到什麼？

你的目標須要具體，以便你能夠將全部精力集中在一個主要想法上。 對於這篇文章，目標不能只是「寫博客」。 我須要一個更具體的目標：

• 受衆：想要開始撰寫博客的人，特別是有關技術主題的人，但尚未作到。
• 目標：爲人們提供一套具體的步驟和指示，以便他們能夠開始。

一旦有了這些，經過刪除任何沒有用的東西來保證你的文章主旨，避免添加額外的細節，由於他們須要有關聯。 我發現相對簡潔的帖子，閱讀時間在 5-10 分鐘時是成功機率最大的。

瞭解觀衆的知識背景可以根據他們現有的知識提煉文章，有助於肯定如何發佈和宣傳文章的內容。 例如，我但願在 freeCodeCamp 上發佈這個，由於目標受衆中的不少人可能已經閱讀過該出版物。

3.有一個好的開頭結尾而且內容翔實

當文章結構走向奇怪時，會讓人迷惑。 劇情曲折在虛構的短篇小說中多是一個很大的好處。但若是能讓讀者得到想要的知識，那麼這會是一篇更容易被閱讀完的技術文章。 良好的文章結構，可讓讀者順利完成閱讀。

介紹

文章的第一段或第二段通常既不能吸引讀者的注意也不會讓他們失去興趣。開篇能夠用一小段話和一副大圖來幫助讀者理解文章的主旨。而後，告訴讀者他們閱讀此文會知道什麼。提早揭祕可能很誘人，但要注意：若是你沒有好的提示，讀者就不會圍繞這個點去閱讀。

中間

如今已經告訴讀者會閱讀什麼，請知足他們的期待！你能夠根據本身的須要隨意添加詳細信息，並在途中留下標誌性文章以引導他們。多多使用標題，編號列表等來幫助讀者瞭解他們閱讀到文章的哪一個部分，使他們可以跳讀到他們最感興趣的部分。

結論

不要在文章末尾一會兒就結束。若是你的讀者已經讀完了全部的內容，他們仍然會關注最後還有什麼。給他們一個所學東西的快速總結，一篇文章的最後也可能只是告訴他們若是感興趣就快行動起來吧。

關於結構部分，我所建議的也許不是最有創意的，應該還有其餘方法能夠作到更好。 但簡單的結構是與讀者溝通的最直接方式。

就像路標同樣 文章的結構樣應該能指引讀者

4.得到反饋並進行迭代

在你閱讀以前，你不會知道人們會從你的寫做中獲得什麼。這纔是你所設想的主題，目標，文章細節和結構真正受到考驗的地方。若是想得到好結果，則不能跳過此步驟。

當你想要得到反饋意見時，你可能以爲本身有點強勢，或者你可能會擔憂這會產生負面影響，可是人們比你指望的更願意提供幫助。在將文章發佈到外面以前，最好先了解一下如何發佈文章效果會更好。當我把這些都考慮進去時，我獲得了一些很是有價值的反饋，使得文章內容更好，更有針對性。

你應該向你的讀者問些什麼呢？個人主要建議是儘量保持開放性。儘可能不要事先解釋你的意圖。按原樣移交草案，並詢問您的審稿人他們從中獲得了什麼或應該更改什麼。當互聯網上有人遇到您的文章時，他們是沒有任何額外的（和讀者認識啊這種的）背景的獨立個體。

從反饋中驗證的主要內容是：此帖子是否會實現您在第 2 步中肯定的目標？保持迭代，直到你肯定能明確目標和受衆。

5.添加最後潤色：包裝，發佈和宣傳

既然你已經有了這個想法，目標，結構和一些反饋，那麼如今是時候對全部東西進行潤色併發布它了。

包裝

想出一個好的標題和副標題，並確保你的文章至少有一張圖。這是人們在 Twitter 或 Facebook 上分享文章時會看到的內容，也是讓人們對閱讀此文感興趣的機會。

文章看起來和感受起來都要很專業，這十分重要，這樣纔可以讓內容真正有意義。最低目標應該是在文章中沒有拼寫錯誤，語法錯誤或奇怪的格式。若是您有一位很是善於發現小細節的朋友，請讓他們在發佈前仔細閱讀。

在 freeCodeCamp 上發佈文章也有一些關於編寫樣式和格式的好建議。既然你已經在你的文章中投入了太多的精力，那麼額外增長一點努力來真正地完善它使之受衆更普遍是很是值得的。

最後，請備註上引用的做品或幫助審覈和修改帖子的人來表達謝意。

發佈

終於到了這一步！選擇你計劃發佈文章的網站，以便最有可能覆蓋你的受衆羣體。Medium 一般是技術文章的聚集地，讓人們很容易看到你的文章。

關於獎勵，嘗試將你的文章發佈到相關的技術網站中，以便於他們幫助分享你的文章 - 由此考慮，我選擇了 freeCodeCamp，由於我認爲這篇文章與他們的讀者有關。若是你也想這樣作，請按如下方式提交你的文章。你感興趣的領域的技術網站也可能正在尋找文章，因此不要懼怕聯繫！

宣傳

雖然你已經發布了文章，可是還沒完事！若是你但願人們看到你撰寫的內容並從中獲取價值，請務必在讀者可能會瀏覽的地方分享。這可能包括 Facebook 羣組，Reddit，黑客新聞，LinkedIn 或任何其餘平臺。此外，請務必在你本身的社交媒體賬戶（如 Twitter）上分享你的創做。你的朋友會很高興閱讀，分享和同意你寫的東西！

如今，你已經完成了。去喝咖啡或散步 - 從開始到結束一篇博文都是不小的壯舉。閱讀社區的任何反饋和回覆，以便你能夠不斷改進。當你有另外一個想法時，就再去寫一篇吧！

精美的圖片可以錦上添花

練習沒有替代品

在寫做時，咱們只是介紹了五個最重要的事情，從提出想法到發佈。 如今你已經閱讀過了，你嘗試應用這個建議，看看哪些對你有用。

我會留下最後一點建議。 我在過去 3 年中從博客中學到的主要內容是，我絕對沒法預測哪些文章會無人問津，哪些文章最終會成爲一個完整的系列。 有時候，我會花費好幾天的時間來打磨一篇文章的每一個細節，不容許一點錯誤。 也有時候，只是在深夜花了幾個小時寫的「GraphQL vs. REST」，成爲了我有史以來最熱門的文章。

所以，即便你的第一篇，第二篇或第三篇文章沒有成功，也要繼續嘗試新的東西，把你的想法寫出來，並隨着時間的推移而改進。 世界想要聽到你要說的話。 去告訴他們！

很是感謝 Anvisha Pai，Angela Zhang，Katie Siegel 和 freeCodeCamp 的編輯幫助審閱這篇文章。