學(xué)習(xí)編程用什么做筆記比較好？

【2017年底的更新】

此次更新主要針對評論里幾個問題：

寫編程日記有什么作用呢

可以參見：寫日記有什么好處?做讀書筆記有何作用？

總結(jié)來說，是為了理清脈絡(luò)，為了加強記憶，為了發(fā)現(xiàn)不足，為了方便反思。

2年半過去了，有沒有什么新的體會？

體會就是：選擇更加多樣，應(yīng)用愈加成熟，支持 Markdown, 對代碼的渲染基本成了共識。

下面我將此前沒有提到的筆記應(yīng)用做一個補充：

1. 眼前一亮的集大成者（你可以把腦子交給它，是 Evernote 理念的延續(xù)）
1. Bear - Write beautifully on iPhone, iPad, and Mac 據(jù)說用的人會上癮
2. Notion – Docs, Wikis, Tasks. Seamlessly in one. 管理自己就像管理一個團隊
2. 即是文檔又是書（既然筆記要公開，就得像個樣子，是 Wiki 類理念的延續(xù)）
1. GitBook - Documentation made easy
2. Read the Docs
3. 項目文檔類工具：
1. MkDocs (Python) 可將主題調(diào)為上述 readthedocs 風(fēng)格。
2. Docusaurus · Easy to Maintain Open Source Documentation Websites
3. docsify (JavaScript) 輕量簡潔
4. docpress (上面的同類)
3. 筆記就是博客 (寫什么筆記？我只是在寫博客(網(wǎng)頁)，是各類在線筆記工具的延續(xù)）
1. 各種靜態(tài)頁面生成工具：StaticGen
2. 在線寫在線發(fā)布
1. HackMD - Collaborative markdown notes
2. Editor.md - 開源在線 Markdown 編輯器
4. 專注于寫的客戶端（讓寫 Markdown 這件小事成為藝術(shù)，是離線筆記工具的延續(xù)）
1. typora - a minimal markdown editor, markdown reader. 所見即所得的極致
2. Visual Studio Code - Code Editing. Redefined 沒看錯，如果你是一個 純粹的Markdown 原教旨主義者，強烈建議這貨，配上 markdownlint - Visual Studio Marketplace插件爽歪歪。微軟出品實在無法抗拒，基于它的插件生態(tài)也逐漸繁榮
1. Markdown+Math - Visual Studio Marketplace 對于數(shù)學(xué)公式的支持
2. Markdown Shortcuts - Visual Studio Marketplace 飛起的快捷鍵
3. EverMonkey 連接 Evernote 和 Markdown 的還有我！詳見 使用 VS Code 感受最佳的印象筆記編輯體驗 - V2EX
3. Quiver - The Programmer's Notebook 在 MAC 上當(dāng)仁不讓
5. 基于 Github 生態(tài)鏈 ( 大 Github 無所不能，是 Github 筆記的延續(xù)）
1. LEPTON - A Lean GitHub Gist Client 基于 Gist 的極致工具
2. jlord/offline-issues 盡情使用 Issues 記筆記，離線也可以看
3. Github 本身就是最好的工具，建立一個 repository，記錄你的一切。
6. 不止編程，還有數(shù)學(xué)(隨著 AI 的流行，程序員筆記越來越需要對于公式以及圖表的支持)
1. The Jupyter Notebook 讓你的筆記動起來。
7. 請直接給我代碼（我是程序員，別給我那些妖艷賤貨，Show me the code.）
1. Markdeep 升級版的 Markdown，你負責(zé)寫 md, 加個 js 變成 HTML。
2. Pandoc - About pandoc 任何文檔格式的終極奧秘，你隨便寫，它來轉(zhuǎn)。
3. Strapdown.js - Instant and elegant Markdown documents 寫 Markdown 還是寫 HTML 傻傻分不清

以上 7 種武器，總有一款適合你。

=============原答案分界線================

【常規(guī)筆記攻略】
1、筆記格式化最好的選擇無疑是 Markdown 語法。(越來越成為通用格式，對代碼有極好的支持)
對于它的簡介與使用方法可以參考這個回答：怎樣引導(dǎo)新手使用 Markdown？
另參見：Markdown

2、使用人數(shù)最多的電子筆記是Evernote，國內(nèi)版本叫做印象筆記。
對于它的介紹可以參考這個回答：印象筆記（Evernote）有哪些常見的用途？
其主頁：印象筆記 | 記錄點點滴滴

3、連接這兩者的工具，可以選擇馬克飛象。
地址如下：http://maxiang.info/
------------------------------------------------------------------
由于馬克飛象越做越好，功能越來越強大，所以作者已經(jīng)開始收費。無法割舍的同志們可以花點小錢鼓勵一下作者。沒錢的屌絲們，可以考慮安裝 Markdown Here 插件，這樣就可以直接在印象筆記Web端直接進行Markdown書寫，然后一鍵轉(zhuǎn)化，非常方便。
--------------------------------------------------------------
印象筆記不支持 Markdown 這一點廣受大家詬病, 最近又發(fā)現(xiàn)一個新產(chǎn)品: leanote. 可以看到界面和印象筆記非常相似, 但提供了更多強勁的功能(當(dāng)然包括Markdown), 并且還提供了桌面客戶端: Leanote App. 最關(guān)鍵是它開源, 支持自己部署, 工具控們可以自己動手, 改進自己的工具.
它還比較年輕, 估計Bug也不少, 僅供熱愛倒騰的程序員嘗試吧.

利用 Evernote 做好筆記的技巧和習(xí)慣，網(wǎng)上有很多前輩分享他們的使用心得。也可以搜來看看。

請見：印象筆記之使用竅門

----------------------------------------------------------------

其他同類工具：

• Cmd Markdown 編輯閱讀器 (參考這個答案: 作業(yè)部落出品的Cmd Markdown 編輯閱讀器怎么樣？有沒有同類型的更好的呢？ 目前Google Markdown 編輯器排名第一)
• 簡潔優(yōu)雅的筆記工具raysnote (具體可以參考 @Raysmond 的答案. 非常優(yōu)雅.)
• https://stackedit.io/editor (相當(dāng)經(jīng)典的工具, 可以和Dropbox或Google Drive同步, 其 PDF 導(dǎo)出功能目前仍是絕對領(lǐng)先狀態(tài), 可以看下效果, 相當(dāng)驚艷. 絕非Chrome打印呈現(xiàn)的效果可比.)
• Markdown Plus (又來一個和上面哥仨 PK 的工具)
• MWeb - 專業(yè)的Markdown寫作、記筆記、靜態(tài)博客生成軟件 (這個不一樣，是客戶端)

----------------------------------------------------------------
再次更新：

不知道大家現(xiàn)在打開馬克飛象，Cmd Markdown，還有 StackEdit 有什么感受，我的感受就是，他們仨基友現(xiàn)在越來越像了，功能一致，風(fēng)格一致，連說明文檔也差不離。在線 Markdown 筆記工具層出不窮，而這哥仨貌似代表了目前業(yè)界最高水平了。

這次我想給大家推薦一個不太一樣的：SegmentFault 的博客，這是一個關(guān)于編程問答方面的社區(qū)，中國版的 StackOverflow，而卻提供了一個獨特的博客功能（申請就有），在用過一段時間之后，我發(fā)現(xiàn)其內(nèi)置的那個 Markdown 編輯器異常的好用，它或許沒有上面哥仨那樣眼花繚亂的功能，但簡潔干凈，反應(yīng)快速，寫起筆記來異常的舒爽。結(jié)合問答社區(qū)的氣氛，我覺得非常適合用來做學(xué)習(xí)編程時的筆記。這是我自己的：C/C++ 的奇技淫巧(雕蟲小技) 可以看看樣子。

有人會說，我不愿把我的筆記公開。嗯，它還提供了一個"隱藏"功能，隨時隱藏，自己獨享。

=====================================
【Github 筆記攻略】

學(xué)習(xí)編程的人，往往繞不過 Github，經(jīng)過這段時間的嘗試，我發(fā)現(xiàn) Github 的確有很適合做筆記的地方。
但，不太建議用 issue，其最大的問題在于不支持 git 操作，即備份及版本管理非常麻煩。
顧名思義啊，issue是提出問題，討論問題的地方，用這個寫筆記，抑或是寫博客。的確非常特立獨行，但是否真的合適，值得商榷。

那么在 Github 我推薦什么？

首先，是 Wiki，About GitHub Wikis · GitHub Help。這個東西的初衷是用來做項目說明文檔的，而文檔，不就是更規(guī)范的一種筆記形式嗎？況且， Wiki 因其自身特性，本來就是最高效知識整理工具，大牛們用 Wiki 來積累知識與技能的例子數(shù)不勝數(shù)：例如閑耘?. Wiki ，第一次看到時真的把我震撼到了。用 Github 自帶的 Wiki 做筆記，更加不用操心搭建環(huán)境的事情，你堅持寫就好了。貼一個我自己的示例：pezy's wiki

其次，是 Gists，這個東西的初衷是便于你在博客里方便的嵌入代碼塊。但我們的思維不應(yīng)該局限于此，還是先上例子：具體編程語言重要概念筆記。有沒有感覺很棒？ Gist 在我看來就像一個隨手的小貼士（便簽），可以在你靈感突發(fā)，或者急需總結(jié)某個知識點的時候，隨意打開，隨意保存。天然支持貼代碼，同時具備 Github 特色的 Markdown 渲染。

如果你還使用Chrome，一定要考慮安裝一下這個插件：GistBox ，它能夠智能抓捕到網(wǎng)頁上的代碼塊，一鍵保存至你的 Gist 中，那些互聯(lián)網(wǎng)的搬運工們，這難道不是必備的神器么。另外，它的管理界面極具特色，將 Github 中 Issue 的最大優(yōu)點——定義標(biāo)簽，給搬到 Gist 中。簡直是專為筆記而考慮呀。

注：GistBox 貌似已經(jīng)失效，其作者另起了一個新的作品：Cacher - The code snippet organizer for pro developers 歡迎使用。

上述兩個工具都支持 Git 操作（應(yīng)該是程序員必備技能了吧），可以隨時備份回滾，不用擔(dān)心筆記丟失、被覆蓋、誤刪等等問題。

=====================================
【讀書筆記攻略】

學(xué)習(xí)編程，大多數(shù)同學(xué)還是會基于書籍，那么看書學(xué)習(xí)時，用什么做筆記比較好呢？

應(yīng)該要推薦的是豆瓣讀書筆記，以前一直沒有注意，大多數(shù)上豆瓣的也都是文藝青年，誰也沒想過在上面寫編程筆記，直到我決定開始重新啃一些大塊頭書籍，在豆瓣上搜書單的時候，才發(fā)現(xiàn)，居然有如此便利的工具。而且豆瓣讀書筆記專為讀書而生，頁碼、章節(jié)等小細節(jié)讓你覺得非常貼心，回頭需要找的時候也會非常方便。更可以和同時讀這本書的人一起討論問題，共同進步。這是其他筆記無法比擬的優(yōu)勢。

同樣的, 如果使用Chrome, 一定考慮安裝 豆瓣讀書筆記插件, 界面相當(dāng)美觀, 對代碼的渲染也非常漂亮. 可以在其主頁: 讀書筆記 查看更多內(nèi)容, 或者犒勞下作者.

================
最后的話

隨著互聯(lián)網(wǎng)的迅猛發(fā)展，出現(xiàn)了越來越多的工具，而且一個比一個方便易用。也許這個答案我會不斷的更新。

但這些僅僅只是工具而已，關(guān)鍵，還在用工具的人。共勉！

謝謝這些工具的開發(fā)者，他們的用心良苦為我們節(jié)省了大量的精力。

還要謝謝點贊的人，你們是我更新的動力。 :)