学习编程用什么做笔记比较好?
共 4767字,需浏览 10分钟
·
2022-02-09 17:29
【2017年底的更新】
此次更新主要针对评论里几个问题:
写编程日记有什么作用呢
可以参见:写日记有什么好处?做读书笔记有何作用?
总结来说,是为了理清脉络,为了加强记忆,为了发现不足,为了方便反思。
2年半过去了,有没有什么新的体会?
体会就是:选择更加多样,应用愈加成熟,支持 Markdown, 对代码的渲染基本成了共识。
下面我将此前没有提到的笔记应用做一个补充:
- 眼前一亮的集大成者(你可以把脑子交给它,是 Evernote 理念的延续)
- Bear - Write beautifully on iPhone, iPad, and Mac 据说用的人会上瘾
- Notion – Docs, Wikis, Tasks. Seamlessly in one. 管理自己就像管理一个团队
- 即是文档又是书(既然笔记要公开,就得像个样子,是 Wiki 类理念的延续)
- GitBook - Documentation made easy
- Read the Docs
- 项目文档类工具:
- MkDocs (Python) 可将主题调为上述 readthedocs 风格。
- Docusaurus · Easy to Maintain Open Source Documentation Websites
- docsify (JavaScript) 轻量简洁
- docpress (上面的同类)
- 笔记就是博客 (写什么笔记?我只是在写博客(网页),是各类在线笔记工具的延续)
- 各种静态页面生成工具:StaticGen
- 在线写在线发布
- 专注于写的客户端(让写 Markdown 这件小事成为艺术,是离线笔记工具的延续)
- typora - a minimal markdown editor, markdown reader. 所见即所得的极致
- Visual Studio Code - Code Editing. Redefined 没看错,如果你是一个 纯粹的Markdown 原教旨主义者,强烈建议这货,配上 markdownlint - Visual Studio Marketplace插件爽歪歪。微软出品实在无法抗拒,基于它的插件生态也逐渐繁荣
- Markdown+Math - Visual Studio Marketplace 对于数学公式的支持
- Markdown Shortcuts - Visual Studio Marketplace 飞起的快捷键
- EverMonkey 连接 Evernote 和 Markdown 的还有我!详见 使用 VS Code 感受最佳的印象笔记编辑体验 - V2EX
- Quiver - The Programmer's Notebook 在 MAC 上当仁不让
- 基于 Github 生态链 ( 大 Github 无所不能,是 Github 笔记的延续)
- LEPTON - A Lean GitHub Gist Client 基于 Gist 的极致工具
- jlord/offline-issues 尽情使用 Issues 记笔记,离线也可以看
- Github 本身就是最好的工具,建立一个 repository,记录你的一切。
- 不止编程,还有数学(随着 AI 的流行,程序员笔记越来越需要对于公式以及图表的支持)
- The Jupyter Notebook 让你的笔记动起来。
- 请直接给我代码(我是程序员,别给我那些妖艳贱货,Show me the code.)
- Markdeep 升级版的 Markdown,你负责写 md, 加个 js 变成 HTML。
- Pandoc - About pandoc 任何文档格式的终极奥秘,你随便写,它来转。
- Strapdown.js - Instant and elegant Markdown documents 写 Markdown 还是写 HTML 傻傻分不清
以上 7 种武器,总有一款适合你。
=============原答案分界线================
【常规笔记攻略】
1、笔记格式化最好的选择无疑是 Markdown 语法。(越来越成为通用格式,对代码有极好的支持)
对于它的简介与使用方法可以参考这个回答:怎样引导新手使用 Markdown?
另参见:Markdown
2、使用人数最多的电子笔记是Evernote,国内版本叫做印象笔记。
对于它的介绍可以参考这个回答:印象笔记(Evernote)有哪些常见的用途?
其主页:印象笔记 | 记录点点滴滴
3、连接这两者的工具,可以选择马克飞象。
地址如下:http://maxiang.info/
------------------------------------------------------------------
由于马克飞象越做越好,功能越来越强大,所以作者已经开始收费。无法割舍的同志们可以花点小钱鼓励一下作者。没钱的屌丝们,可以考虑安装 Markdown Here 插件,这样就可以直接在印象笔记Web端直接进行Markdown书写,然后一键转化,非常方便。
--------------------------------------------------------------
印象笔记不支持 Markdown 这一点广受大家诟病, 最近又发现一个新产品: leanote. 可以看到界面和印象笔记非常相似, 但提供了更多强劲的功能(当然包括Markdown), 并且还提供了桌面客户端: Leanote App. 最关键是它开源, 支持自己部署, 工具控们可以自己动手, 改进自己的工具.
它还比较年轻, 估计Bug也不少, 仅供热爱倒腾的程序员尝试吧.
利用 Evernote 做好笔记的技巧和习惯,网上有很多前辈分享他们的使用心得。也可以搜来看看。
请见:印象笔记之使用窍门
----------------------------------------------------------------
其他同类工具:
- Cmd Markdown 编辑阅读器 (参考这个答案: 作业部落出品的Cmd Markdown 编辑阅读器怎么样?有没有同类型的更好的呢? 目前Google Markdown 编辑器排名第一)
- 简洁优雅的笔记工具raysnote (具体可以参考 @Raysmond 的答案. 非常优雅.)
- https://stackedit.io/editor (相当经典的工具, 可以和Dropbox或Google Drive同步, 其 PDF 导出功能目前仍是绝对领先状态, 可以看下效果, 相当惊艳. 绝非Chrome打印呈现的效果可比.)
- Markdown Plus (又来一个和上面哥仨 PK 的工具)
- MWeb - 专业的Markdown写作、记笔记、静态博客生成软件 (这个不一样,是客户端)
----------------------------------------------------------------
再次更新:
不知道大家现在打开马克飞象,Cmd Markdown,还有 StackEdit 有什么感受,我的感受就是,他们仨基友现在越来越像了,功能一致,风格一致,连说明文档也差不离。在线 Markdown 笔记工具层出不穷,而这哥仨貌似代表了目前业界最高水平了。
这次我想给大家推荐一个不太一样的:SegmentFault 的博客,这是一个关于编程问答方面的社区,中国版的 StackOverflow,而却提供了一个独特的博客功能(申请就有),在用过一段时间之后,我发现其内置的那个 Markdown 编辑器异常的好用,它或许没有上面哥仨那样眼花缭乱的功能,但简洁干净,反应快速,写起笔记来异常的舒爽。结合问答社区的气氛,我觉得非常适合用来做学习编程时的笔记。这是我自己的:C/C++ 的奇技淫巧(雕虫小技) 可以看看样子。
有人会说,我不愿把我的笔记公开。嗯,它还提供了一个"隐藏"功能,随时隐藏,自己独享。
=====================================
【Github 笔记攻略】
学习编程的人,往往绕不过 Github,经过这段时间的尝试,我发现 Github 的确有很适合做笔记的地方。
但,不太建议用 issue,其最大的问题在于不支持 git 操作,即备份及版本管理非常麻烦。
顾名思义啊,issue是提出问题,讨论问题的地方,用这个写笔记,抑或是写博客。的确非常特立独行,但是否真的合适,值得商榷。
那么在 Github 我推荐什么?
首先,是 Wiki,About GitHub Wikis · GitHub Help。这个东西的初衷是用来做项目说明文档的,而文档,不就是更规范的一种笔记形式吗?况且, Wiki 因其自身特性,本来就是最高效知识整理工具,大牛们用 Wiki 来积累知识与技能的例子数不胜数:例如闲耘™. Wiki ,第一次看到时真的把我震撼到了。用 Github 自带的 Wiki 做笔记,更加不用操心搭建环境的事情,你坚持写就好了。贴一个我自己的示例:pezy's wiki
其次,是 Gists,这个东西的初衷是便于你在博客里方便的嵌入代码块。但我们的思维不应该局限于此,还是先上例子:具体编程语言重要概念笔记。有没有感觉很棒? Gist 在我看来就像一个随手的小贴士(便签),可以在你灵感突发,或者急需总结某个知识点的时候,随意打开,随意保存。天然支持贴代码,同时具备 Github 特色的 Markdown 渲染。
如果你还使用Chrome,一定要考虑安装一下这个插件:GistBox ,它能够智能抓捕到网页上的代码块,一键保存至你的 Gist 中,那些互联网的搬运工们,这难道不是必备的神器么。另外,它的管理界面极具特色,将 Github 中 Issue 的最大优点——定义标签,给搬到 Gist 中。简直是专为笔记而考虑呀。
注:GistBox 貌似已经失效,其作者另起了一个新的作品:Cacher - The code snippet organizer for pro developers 欢迎使用。
上述两个工具都支持 Git 操作(应该是程序员必备技能了吧),可以随时备份回滚,不用担心笔记丢失、被覆盖、误删等等问题。
=====================================
【读书笔记攻略】
学习编程,大多数同学还是会基于书籍,那么看书学习时,用什么做笔记比较好呢?
应该要推荐的是豆瓣读书笔记,以前一直没有注意,大多数上豆瓣的也都是文艺青年,谁也没想过在上面写编程笔记,直到我决定开始重新啃一些大块头书籍,在豆瓣上搜书单的时候,才发现,居然有如此便利的工具。而且豆瓣读书笔记专为读书而生,页码、章节等小细节让你觉得非常贴心,回头需要找的时候也会非常方便。更可以和同时读这本书的人一起讨论问题,共同进步。这是其他笔记无法比拟的优势。
同样的, 如果使用Chrome, 一定考虑安装 豆瓣读书笔记插件, 界面相当美观, 对代码的渲染也非常漂亮. 可以在其主页: 读书笔记 查看更多内容, 或者犒劳下作者.
================
最后的话
随着互联网的迅猛发展,出现了越来越多的工具,而且一个比一个方便易用。也许这个答案我会不断的更新。
但这些仅仅只是工具而已,关键,还在用工具的人。共勉!
谢谢这些工具的开发者,他们的用心良苦为我们节省了大量的精力。
还要谢谢点赞的人,你们是我更新的动力。 :)