LEARNING IN PUBLIC
用 Markdown 写一篇可长期保存的笔记
让内容留在自己的文件里。标题、代码块、链接与图片,足够开始第一篇记录。
示例笔记 · 用于展示博客的内容与排版,你可以用自己的记录替换。
为什么选择纯文本
Markdown 文件可以用普通编辑器打开,也可以通过 Git 管理历史。即使以后更换博客工具,文字仍然在自己的目录里。
对学习笔记而言,最有价值的不是复杂的排版,而是能持续写、方便找、看得懂。
一篇笔记的骨架
可以从这几个问题开始:
## 我遇到了什么问题
记录出现问题时的环境和现象。
## 我做了哪些尝试
说明命令的作用,以及观察到的结果。
## 最后怎样解决
记录真正生效的方法。
## 下次如何避免
给未来的自己留下一个检查点。
代码块里写什么
代码块能保留缩进,并在博客里显示语法高亮。执行命令前,仍然需要解释它的用途和运行位置。
pwd
在 Linux 终端中,pwd 只读显示当前工作目录。这比假设自己一直在同一个目录里更可靠。
图片与链接
将图片和文章放在同一个目录,可以减少迁移时链接失效的问题。截图前记得遮挡令牌、密码、私钥和个人信息。
文章引用外部资料时,注明来源和阅读日期。技术文档会更新,过去正确的参数不一定永远适用。
先发布,再完善
没有必要等到“彻底学会”再开始写。可以明确标注还不确定的部分,等验证后再补充。记录真实的理解过程,比整理一份没有实践过的完美答案更有用。