Yianue学习笔记
← 全部笔记

LEARNING IN PUBLIC

用 Markdown 写一篇可长期保存的笔记

让内容留在自己的文件里。标题、代码块、链接与图片,足够开始第一篇记录。

示例笔记 · 用于展示博客的内容与排版,你可以用自己的记录替换。

为什么选择纯文本

Markdown 文件可以用普通编辑器打开,也可以通过 Git 管理历史。即使以后更换博客工具,文字仍然在自己的目录里。

对学习笔记而言,最有价值的不是复杂的排版,而是能持续写、方便找、看得懂。

一篇笔记的骨架

可以从这几个问题开始:

## 我遇到了什么问题

记录出现问题时的环境和现象。

## 我做了哪些尝试

说明命令的作用,以及观察到的结果。

## 最后怎样解决

记录真正生效的方法。

## 下次如何避免

给未来的自己留下一个检查点。

代码块里写什么

代码块能保留缩进,并在博客里显示语法高亮。执行命令前,仍然需要解释它的用途和运行位置。

pwd

在 Linux 终端中,pwd 只读显示当前工作目录。这比假设自己一直在同一个目录里更可靠。

图片与链接

将图片和文章放在同一个目录,可以减少迁移时链接失效的问题。截图前记得遮挡令牌、密码、私钥和个人信息。

文章引用外部资料时,注明来源和阅读日期。技术文档会更新,过去正确的参数不一定永远适用。

先发布,再完善

没有必要等到“彻底学会”再开始写。可以明确标注还不确定的部分,等验证后再补充。记录真实的理解过程,比整理一份没有实践过的完美答案更有用。

找一篇笔记

输入关键词,搜索文章标题和内容。

按 Esc 关闭 · 搜索在你的浏览器内完成