[譯]如何撰寫精彩的技術部落格文章

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

原文連結：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 的編輯幫助審閱這篇文章。