# 14 一种优雅の笔记方式

做笔记真是件麻烦的事，特别是对于我这种 CV 工程师来说，之前看过不少推荐笔记工具的文章和帖子，所以特想安利一下自己花了不少时间摸索出来的一种简单优雅与高效的笔记方式。

自己尝试用过 typora、notion、OneNote、github issues 等几种方式，最后还是发现这种方式用得最舒服。自己最终放弃上述几种笔记工具是因为它们或多或少总是有些自己不能忍受的缺失点：

* typora：没有 md 语法检查和格式化，完美主义者很难受；
* notion：除了需要付费外，它不是标准的 md 语法（我对 md 情有独钟）；
* OneNote：不支持 md，不适合贴代码，太过自由，不适合我这种没有大局观的人，还是 md 适合我；
* github issues：这种方式做笔记太累了，没有目录层级，阅读体验不太行，我主要把它当作自定义博客数据源；

其他的几种笔记方式包括有道云笔记、为知笔记等等都有上面几种缺点（对我来说），它们都未能解决我的痛点：

1. 支持 md 语法检查和格式化（我对 md 情有独钟）
2. 支持全局搜索
3. 支持分类目录
4. 良好的阅读体验，方便查阅
5. 优雅的同步备份方式

直到我发现了 gitbook，发现才是最简单适合我的笔记方式，配合 vscode 简直完美，自己已经成功安利了几个同事使用，用过了都说好 👌。

* vscode + markdownlint 插件，支持 md 语法检查和格式化。
* github + gitbook 自动同步，本地笔记推送到 github，可以自动同步到 gitbook，支持全局搜索与层级目录。

它完美解决了上面我的几个痛点：

* 支持 md 语法检查和格式化
* 支持全局搜索
* 支持分类目录
* gitbook 自动同步
* 完美的阅读体验，高效复习和查阅
* 甚至可以绑定域名当博客使用

最后举个自己的栗子：[蝉时雨の笔记](https://chanshiyu.gitbook.io/blog/)

![蝉时雨の笔记](/files/Hvy3mUuV5wdJsRm6jkGw)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://chanshiyu.gitbook.io/blog/shi-yu/2019/14-no.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.