abc110 发表于 2023-10-26 06:41:45

程序员一般是怎么记自己的编程笔记的？用什么软件记录的？

有道笔记本？Markdown？mind思维导图。手写笔记？好记性不如烂笔头。

ldwr 发表于 2023-10-26 06:42:33

记笔记十几年的经验，告诉你们：
1、需要登录的一律否决，比如xx云笔记。因为你永远不知道这个公司会不会跑路，会不会出完VIP再出超级VIP，会不会拿用户的个人笔记数据搞AI训练。
2、格式缺乏兼容性的一律否决，比如onenote。用它一时爽，转移要抓狂。
3、跨设备能力差的一律否决。因为你可能只是在github手机端看笔记。
4、不能即开即用的一律否决。反例就是有人推荐的outline。web端可通用访问，界面和功能很好，但我也不建议用。主要是依赖环境需要折腾docker下的一系列服务，凡是需要折腾的东西在迁移时都存在风险，尤其是用了十年再去迁移，你会崩溃。
综上的结论是：obsidian。
1、单机可用，完全免费，软件拷贝一个副本可以用一万年，笔记在本地，可以像代码一样版本控制。
2、完全支持md格式。
3、win，linux，macos，ios，andorid全部支持。
4、插件生态无敌，自动格式优化，自动git推送....
给大家说一下我的用法：
用git版本控制obisidian笔记库里的所有文件，包括皮肤和插件设置。
上传到gitee或者github或者局域网git托管，用同步工具实现各端同步。同时设置备份定期备份到个人nas。
最爽的是手机端的笔记界面也可以和pc端一毛一样。

heyond 发表于 2023-10-26 06:43:05

估计再过一段时间，github block 上线后，大概会在程序员群体，抢占所有笔记软件的市场。
github block 是集成在 readme 里面的，等他开放后，会有无数程序员为它写各种脚本拓展的。
看起来 blocks 是 react component. 可以复用和分享。如果有人想尝试可以去 GitHubnext discord 找人给你权限。

可以点开网址看下演示。
到时候肯定会有 vscode 插件。打开 vscode 随便你写。repo 中任何文件都是笔记，一切都是git，github 公有私有repo随便创建，一点其他学习成本都没有。唯一缺点就是网络慢，但是作为程序员的你肯定可以解决网络慢的问题。

GitHub Blocks

ocsic 发表于 2023-10-26 06:43:44

强推Markdown，软件什么的不重要，太多的东西可以编译markdown，就连知乎现在也支持markdown，就是这个。
你点击编辑栏的文档

http://pica.zhimg.com/v2-993a8e9249c3d4c7dd6aa319afda8b9f_r.jpg?source=1940ef5c
然后可以看到，md格式知乎是支持的。

http://picx.zhimg.com/50/v2-304e58dd5f32f7e549ab6d4a7a0b1f2b_720w.jpg?source=1940ef5c
更重要的是，markdown格式几乎支持绝大多数的平台。
这样的好处就显而易见了，那就是写一份可以到处发。

这是我用markdown的一些经验
为什么还会有人使用markdown语法做笔记，不嫌麻烦吗？至于在哪里写markdown，这个工具太多了，我一般用的是vscode，其他的工具有很多，甚至你白板写也没啥问题。

http://picx.zhimg.com/v2-0d5fb7fb6b7ec1f2ecdc9fa3cf15ed1a_r.jpg?source=1940ef5c
学习资料，就用w3schools就行，很简单的，直接照着例子写就行。
https://www.w3schools.io/file/markdown-introduction/

wuchao 发表于 2023-10-26 06:44:43

如果你想找一款对程序员友好的编程笔记软件，支持在一个编辑器里，实现写代码、写公式、画UML图等功能，可以试下 @语雀 。
诞生于蚂蚁体验技术部，最初就是“程序员写给程序员的笔记软件”，拥有不少程序员喜爱的笔记功能。
<hr/>本文有生成目录，不想看全文的，可以直接点击感兴趣的部分！
1. 专业好用的编辑器

语雀自研的编辑器，具备 Markdown、代码块、LaTeX 公式、PlantUML 等专业编辑能力，十分贴合程序员朋友的使用习惯。
你可以用 /（斜杠）调出特色卡片，里面有语雀支持的所有高阶和第三方功能。

http://picx.zhimg.com/v2-4187fdd0c59c179d0767ea8bea5a9076_r.jpg?source=1940ef5c
需要哪个，在/ 后输入对应卡片的拼音缩写，比如输入/dmk ，就能插入代码块。

http://picx.zhimg.com/v2-401c2360915781e40213296a46c2796f_r.jpg?source=1940ef5c

代码块

语雀的代码块功能支持选择指定的编程语言，同时还提供了深色主题在内的 6 种样式。

http://pica.zhimg.com/v2-49e0b01536176d9359325400717d91ca_r.jpg?source=1940ef5c

[*]支持折叠代码块卡片、整段代码块、行内折叠。写再长的代码，也完全没问题了~
[*]支持代码块的高亮、命名、隐藏行号、收起顶部栏、格式化代码、缩进宽度和缩进模式 等功能。

http://picx.zhimg.com/v2-b1e1a11eef03963f1ae7f61e28d937ce_r.jpg?source=1940ef5c
除了丰富的代码块编辑能力，语雀支持几乎所有常见编程语雀代码文件直接在线预览，通过附件形式上传，然后点击预览。

http://picx.zhimg.com/v2-c3cedc8c0e58350e225f196ae73b1049_r.jpg?source=1940ef5c

在第三方功能中，我们接入了稀土掘金开发的实时代码演示产品「码上掘金」。只要将链接粘贴过来，就能直接在语雀运行。

http://picx.zhimg.com/v2-991c22f960c1a0d04ed81398dbcba431_r.jpg?source=1940ef5c
可以点击下方链接，在语雀新建个文档，试试咱的代码编辑功能，到底有没有我说的那样好用 ▼▼
https://xg.zhihu.com/plugin/994f7113b25485f2f0b8dbd0699fb30f?BIZ=ECOMMERCE
绘图功能

除了写代码，记笔记的时候可能需要画个图，比如流程图、思维导图等。
在语雀，使用语雀自主研发的【画板】功能，无须接入任何第三方工具，在编辑页面就可以开始画图了！

http://picx.zhimg.com/v2-c4e160ee69d2ce4bfa5871a75b66914d_r.jpg?source=1940ef5c
最近，我们还为画板增加了手绘风格在内的多套主题样式。

http://pic1.zhimg.com/v2-a0f677ec3a029e9b9e967e047d097416_r.jpg?source=1940ef5c
更有趣的是，在画板，不同类型的图是可以自由组合的，比如：思维导图 + 流程图 ▼▼

http://picx.zhimg.com/v2-f07cc68667231b05076418b9410817f5_r.jpg?source=1940ef5c

此外，语雀画板还提供了一些基础图形。能画出什么样的图，全看大家的需求~

http://pic1.zhimg.com/v2-9d95806cf0f9a76f35c440f52ebf21fb_r.jpg?source=1940ef5c

比如你可以像 @小胡子哥一样，在写笔记的时候，画一张这样的示意图，帮助自己更好地理解信息。

http://picx.zhimg.com/v2-840721efee2772733a176b0ad68687ff_r.jpg?source=1940ef5c

当然，如果你想“偷懒”，语雀画板还自带素材库，并且接入了图标库 iconfont 。

http://pic1.zhimg.com/v2-5f2b404392a9d98dd2e85543924ad8f3_r.jpg?source=1940ef5c
如果你也喜欢这种，能在一个页面，一边码字，一边绘图的编辑体验，欢迎点击下方链接，体验语雀自主研发的【画板】工具，轻松搞定思维导图、流程图、时序图等图形 ▼▼
https://xg.zhihu.com/plugin/994f7113b25485f2f0b8dbd0699fb30f?BIZ=ECOMMERCE
LaTeX 公式

目前语雀采用 Katex 库生成LaTeX数学公式。
输入的时候，公式支持行内嵌套，也支持块级嵌入。

http://picx.zhimg.com/v2-c8ec5122863941aca10d1a69509e81d1_r.jpg?source=1940ef5c

此外，也支持更改行内字体大小和调整颜色。

http://pic1.zhimg.com/v2-76b62663c74f63f2d646707880e3748d_r.jpg?source=1940ef5c

Markdown语法

语雀编辑器，支持绝大多数 Markdown 语法，内容实时渲染，所见即所得。

http://pic1.zhimg.com/v2-b45ac55f4c0da2289da566f41063cc1b_r.jpg?source=1940ef5c

如果想要获得在文档的 markdown 格式文本，在链接后面加个 /markdown 即可。

http://picx.zhimg.com/v2-9c177051242bf234c8119679d7a7422f_r.jpg?source=1940ef5c

2.支持记录碎片笔记

语雀虽然强调笔记的结构化，但同时也提供了记录碎片笔记的功能 —— 【小记】功能。
当你在电脑上工作时，突然有个想法，但来不及展开写，就可以按下 Ctrl + Shift + Y，调出【小记】窗口，快速记下来。记完窗口会自动关闭。

http://pica.zhimg.com/v2-987089fbc6508553f6b71468244934a2_r.jpg?source=1940ef5c

如果电脑不在身边，可以用手机端的「小记」记录，支持插入代码块、视频、附件等。小记虽小，能量却很大。

http://pica.zhimg.com/v2-858c6ebf229a776e5102b0e7c33484a3_r.jpg?source=1940ef5c

3. 结构化的笔记管理

等到有大块的时间，你可以把写好的「小记」插入到文档中，在原有基础上扩写。

http://picx.zhimg.com/v2-0f566a6869b36689d6fbc6c0968ac837_r.jpg?source=1940ef5c
▌像书一样管理笔记
在语雀，文档是用「知识库」的方式进行管理。一个知识库就像一本“书”，一篇篇文档组成了“书”的目录，看上去井井有条。

http://picx.zhimg.com/v2-6a2d3bb4a7f1458c64810ba49020f9dd_r.jpg?source=1940ef5c
在语雀，没有文件夹 — 子文件夹的概念。如果需要将文档分类，可直接通过「新建分组」的功能。

http://pica.zhimg.com/v2-f7d55d23129d4172339d3030511b7f64_r.jpg?source=1940ef5c

要是觉得哪里的文档顺序不对，可以通过拖动的方式调整。非常灵活~

http://pic1.zhimg.com/v2-b4cfadd16815a0013ce5a49b38b42426_r.jpg?source=1940ef5c

▌清晰的内容呈现方式
打开知识库，左边是文档目录，右边是文档大纲，可以快速定位到要查看的内容。

http://pic1.zhimg.com/v2-16cd72722a5244c3523262d56f90e95b_r.jpg?source=1940ef5c
工具圈里有句话：我们塑造工具，工具也塑造我们。一个趁手的工具，确实能在某种程度上，帮助我们改变自己的思维方式。
语雀通过知识库、目录、大纲功能，让多篇文档结构化，像书一样清晰易读。如果你也喜欢这种文档管理方式，可以点击下方链接，体验一下 ▼▼
https://xg.zhihu.com/plugin/994f7113b25485f2f0b8dbd0699fb30f?BIZ=ECOMMERCE<hr/>4. 开放的 API 和第三方生态

对于笔记文档工具，程序员通常也会有许多个性化的需求，比如在自己的博客和平台里随时同步内容等。
对于这样的个性化需求，语雀面向有开发能力的用户推出了 OpenAPI 以满足需求：
Overview · 语雀在个人的账号设置里，就可以方便的申请开发权限 ▼▼

http://picx.zhimg.com/v2-541dc91b7bd282c58e7763d9da5d1e8e_r.jpg?source=1940ef5c
API 通过 Auth2.0 进行鉴权，具备以下功能：

[*]读取授权用户相关信息；
[*]创建、读取、更新、删除知识库；
[*]创建、读取、更新、删除文档。
当然，如果你不想折腾，就想安安心心写笔记，语雀现有的功能应该都能满足哦。
https://xg.zhihu.com/plugin/994f7113b25485f2f0b8dbd0699fb30f?BIZ=ECOMMERCE
如果有特别需要的功能，也欢迎在评论区给我留言呀~

ma625748 发表于 2023-10-26 06:44:49

1. 用最顺手的工具记录，随时记录，并且不依赖平台

VSCode，没有什么比用日常开发工具更方便的了。从 Evernote, 有道笔记一路用过来，发现都不顺手。功能升级、Monetize 模式、同步问题都让我很头疼。
后来只用 VSCode，同步用 iCloud 或者 Github（以前用 Github，现在换 iCloud）。

[*]日常记录:Markdown
[*]图： Mermaid 插件
[*]代码： Code Runner
记录想法直接上纸笔，之后拍照存档。
如果想随地记录，手机的默认的 Note 软件足够用了，再配合相机，满足大部分需求。

http://picx.zhimg.com/v2-b0d283623ea179913b91dfd6abaf9b70_r.jpg?source=1940ef5c
2. 笔记的重点在于整理，不在于怎么记。

目前用 Notion 整理，实在是太好用。以发布为目的进行整理，比如：

[*]发表博客
[*]写书
[*]做成视频教程
[*]做成音频节目
[*]等等...
整理的时候可以假象一个听众，让后整理给听众看。（其实是写给未来的自己看）。

http://pic1.zhimg.com/v2-8d7c7d957fbd1ac377551143d7c7533b_r.jpg?source=1940ef5c
3. 回顾整理后的笔记

每周、每月、每年。按照自己的习惯来。读读自己给自己写的“信”，会非常有收获。
一定要把笔记整理成自己未来想读、想看的东西。
以前用 Trello 管理和回顾自己的内容，最近在慢慢迁移到 Notion。

http://pic1.zhimg.com/v2-ab456dcb1cdb2849ae56d4e74e9da492_r.jpg?source=1940ef5c
页: [1]
查看完整版本: 程序员一般是怎么记自己的编程笔记的？用什么软件记录的？