学习编程用什么做笔记比较好?

共 4767字,需浏览 10分钟

 ·

2022-02-09 17:29

2017年底的更新

此次更新主要针对评论里几个问题:

写编程日记有什么作用呢

可以参见:写日记有什么好处?做读书笔记有何作用?

总结来说,是为了理清脉络,为了加强记忆,为了发现不足,为了方便反思

2年半过去了,有没有什么新的体会?

体会就是:选择更加多样,应用愈加成熟,支持 Markdown, 对代码的渲染基本成了共识

下面我将此前没有提到的笔记应用做一个补充:

  1. 眼前一亮的集大成者(你可以把脑子交给它,是 Evernote 理念的延续)
    1. Bear - Write beautifully on iPhone, iPad, and Mac 据说用的人会上瘾
    2. Notion – Docs, Wikis, Tasks. Seamlessly in one. 管理自己就像管理一个团队
  2. 即是文档又是(既然笔记要公开,就得像个样子,是 Wiki 类理念的延续)
    1. GitBook - Documentation made easy
    2. Read the Docs
    3. 项目文档类工具:
      1. MkDocs (Python) 可将主题调为上述 readthedocs 风格。
      2. Docusaurus · Easy to Maintain Open Source Documentation Websites
      3. docsify (JavaScript) 轻量简洁
      4. docpress (上面的同类)
  3. 笔记就是博客 (写什么笔记?我只是在写博客(网页),是各类在线笔记工具的延续)
    1. 各种静态页面生成工具:StaticGen
    2. 在线写在线发布
      1. HackMD - Collaborative markdown notes
      2. Editor.md - 开源在线 Markdown 编辑器
  4. 专注于写的客户端(让写 Markdown 这件小事成为艺术,是离线笔记工具的延续)
    1. typora - a minimal markdown editor, markdown reader. 所见即所得的极致
    2. Visual Studio Code - Code Editing. Redefined 没看错,如果你是一个 纯粹的Markdown 原教旨主义者,强烈建议这货,配上 markdownlint - Visual Studio Marketplace插件爽歪歪。微软出品实在无法抗拒,基于它的插件生态也逐渐繁荣
      1. Markdown+Math - Visual Studio Marketplace 对于数学公式的支持
      2. Markdown Shortcuts - Visual Studio Marketplace 飞起的快捷键
      3. EverMonkey 连接 Evernote 和 Markdown 的还有我!详见 使用 VS Code 感受最佳的印象笔记编辑体验 - V2EX
    3. Quiver - The Programmer's Notebook 在 MAC 上当仁不让
  5. 基于 Github 生态链 ( 大 Github 无所不能,是 Github 笔记的延续)
    1. LEPTON - A Lean GitHub Gist Client 基于 Gist 的极致工具
    2. jlord/offline-issues 尽情使用 Issues 记笔记,离线也可以看
    3. Github 本身就是最好的工具,建立一个 repository,记录你的一切。
  6. 不止编程,还有数学(随着 AI 的流行,程序员笔记越来越需要对于公式以及图表的支持)
    1. The Jupyter Notebook 让你的笔记动起来。
  7. 请直接给我代码(我是程序员,别给我那些妖艳贱货,Show me the code.)
    1. Markdeep 升级版的 Markdown,你负责写 md, 加个 js 变成 HTML。
    2. Pandoc - About pandoc 任何文档格式的终极奥秘,你随便写,它来转。
    3. Strapdown.js - Instant and elegant Markdown documents 写 Markdown 还是写 HTML 傻傻分不清

以上 7 种武器,总有一款适合你。

=============原答案分界线================

常规笔记攻略
1、笔记格式化最好的选择无疑是 Markdown 语法。(越来越成为通用格式,对代码有极好的支持)
对于它的简介与使用方法可以参考这个回答:怎样引导新手使用 Markdown?
另参见:Markdown

2、使用人数最多的电子笔记是Evernote,国内版本叫做印象笔记。
对于它的介绍可以参考这个回答:印象笔记(Evernote)有哪些常见的用途?
其主页:印象笔记 | 记录点点滴滴

3、连接这两者的工具,可以选择马克飞象。
地址如下:maxiang.info/
------------------------------------------------------------------
由于马克飞象越做越好,功能越来越强大,所以作者已经开始收费。无法割舍的同志们可以花点小钱鼓励一下作者。没钱的屌丝们,可以考虑安装 Markdown Here 插件,这样就可以直接在印象笔记Web端直接进行Markdown书写,然后一键转化,非常方便。
--------------------------------------------------------------
印象笔记不支持 Markdown 这一点广受大家诟病, 最近又发现一个新产品: leanote. 可以看到界面和印象笔记非常相似, 但提供了更多强劲的功能(当然包括Markdown), 并且还提供了桌面客户端: Leanote App. 最关键是它开源, 支持自己部署, 工具控们可以自己动手, 改进自己的工具.
它还比较年轻, 估计Bug也不少, 仅供热爱倒腾的程序员尝试吧.

利用 Evernote 做好笔记的技巧和习惯,网上有很多前辈分享他们的使用心得。也可以搜来看看。

请见:印象笔记之使用窍门

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

其他同类工具:

----------------------------------------------------------------
再次更新:

不知道大家现在打开马克飞象Cmd Markdown,还有 StackEdit 有什么感受,我的感受就是,他们仨基友现在越来越像了,功能一致,风格一致,连说明文档也差不离。在线 Markdown 笔记工具层出不穷,而这哥仨貌似代表了目前业界最高水平了。

这次我想给大家推荐一个不太一样的:SegmentFault 的博客,这是一个关于编程问答方面的社区,中国版的 StackOverflow,而却提供了一个独特的博客功能(申请就有),在用过一段时间之后,我发现其内置的那个 Markdown 编辑器异常的好用,它或许没有上面哥仨那样眼花缭乱的功能,但简洁干净,反应快速,写起笔记来异常的舒爽。结合问答社区的气氛,我觉得非常适合用来做学习编程时的笔记。这是我自己的:C/C++ 的奇技淫巧(雕虫小技) 可以看看样子。

有人会说,我不愿把我的笔记公开。嗯,它还提供了一个"隐藏"功能,随时隐藏,自己独享。

=====================================
Github 笔记攻略

学习编程的人,往往绕不过 Github,经过这段时间的尝试,我发现 Github 的确有很适合做笔记的地方。
但,不太建议用 issue,其最大的问题在于不支持 git 操作,即备份及版本管理非常麻烦。
顾名思义啊,issue是提出问题,讨论问题的地方,用这个写笔记,抑或是写博客。的确非常特立独行,但是否真的合适,值得商榷。

那么在 Github 我推荐什么?

首先,是 WikiAbout 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, 一定考虑安装 豆瓣读书笔记插件, 界面相当美观, 对代码的渲染也非常漂亮. 可以在其主页: 读书笔记 查看更多内容, 或者犒劳下作者.

================
最后的话

随着互联网的迅猛发展,出现了越来越多的工具,而且一个比一个方便易用。也许这个答案我会不断的更新。

但这些仅仅只是工具而已关键,还在用工具的人。共勉!

谢谢这些工具的开发者,他们的用心良苦为我们节省了大量的精力。

还要谢谢点赞的人,你们是我更新的动力。 :)

浏览 6
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报