這個時候有套趁手的寫作工具尤為重要,節省下時間好好休息一下,對於咱們程式設計師來說更加重要。因為最近在自己學習golang,為了找個順手的IDE嘗試了一下VScode,用後總結兩個字:“真香”。集編碼、寫作、划水 於一身。
話不多說,我們今天先說說寫作這部分。
文字內容文字寫作推薦大家使用markdown。大家的經歷應該主要放在文字內容上,可以節省大家的排版時間。雖然marakdown的語法非常簡單,但是一款趁手的markdown編輯器也非常重要。因為今天的主角的VScode,所以大家可以直接在安裝VScode中安裝一下markdown外掛即可,比如:
圖片內容技術寫作經常會畫一些流程圖,架構圖。尤其圖解會然讓複雜的問題更加直觀,更容易理解。所以有個方便的畫圖軟體很重要。原來一直用processon線上畫圖,但是因為個人免費使用者有檔案個數限制,所以不太友好(還是因為窮,哈哈哈)。最近一直用draw.io,並且支援將檔案自動儲存到github,用起來很方便。尤其現在VScode還有對應的外掛,寫字、畫圖都在一個編輯器裡,沉浸感更強了,防止思路再來回切軟體時被打斷。下面時再VScode裡建立一個drawio檔案:
畫完圖匯出為圖片,然後藉助PicGo外掛+github+jsDelivr(不瞭解的同學可以搜尋一下,網上很多詳細文件),自動上傳圖片到github圖床並自動插入到markdown檔案中。VScode也有PicGo對應的外掛,所以這些操作也全再VScode中完成,很方便。
程式碼Talk is cheap. Show me the code.
對於文章中的程式碼,有人習慣用markdown本身的程式碼片段,也有人習慣放程式碼截圖。但是截圖很難截的統一大小,導致不太美觀。這裡推薦用外掛Polacode-2020。
可以把程式碼儲存為統一大小的圖片,然後使用圖片部分的外掛,自動將程式碼圖片插入到文章中。
Markdown All in OnemarkdownlintDraw.io intergrationPicGoPolacode-2020