如何养成写文档的习惯

勿任群疑而阻独见，勿任己意而废人言

前言

每个人或多或少的都有表达的欲望，在不同的人身上表现的不同而已。但是在国内，还是很多程序员不喜欢写技术文章的。一方面确实比较的麻烦，另一方面感觉心里想的东西无法用文字表达出来。其实这些都是因为没有这个意识和习惯造成的。作为程序员和其他的技术工作人员，写文档其实是一个很好的习惯，这个习惯会让自己的思维更加的清晰，自己的内心也更加的清澈。

写文档是用来理清自己思维的，大脑就像是一个房间，而知识就是一本又一本的书籍。当这些越积累越多的时候，就需要每隔一定的时间整理一下，将没用的东西扔出去，将有用的部分分类整理。这样，才能正真保持大脑干净，提高学习能力和处理问题的能力。

如果真的想要养写文档习惯，除了广泛的阅读，也需要让自己在生活中养成勤于思考，善于总结，坚持，乐观这些习惯。

关于学习与思考

学而不思则惘，思而不学则怠。进入到这个高速发展的社会，我们每天都在学习，但是却没有进行有效的思考。不能准确的评估学习到的哪些东西是以后需要的，哪些东西是目前需要的，以后可能很少用到的。学习，不是要什么都学，认为学习的越多越好，其实我觉得作为普通人，只需要学习有用的东西就好了，多了反而适得其反。学习不能贪多，思考可以帮助整理学习的内容。

善于总结

思考过后，很多的想法都会在大脑中存在。所以人也是一个矛盾的集合体，这些想法先不用考虑是否合理。可以先记下来，可以采用电子笔记，目前用的比较多的是印象笔记，有道云笔记，为知笔记等等。可以打个草稿，写下当前的想法。然后再对这些想法进行梳理，去掉一些不切实际的想法，最后留下的想法就是内心最真实的想法。然后将这些整理下来，写成文档进行记录。

坚持习惯

要养成坚持写文档的习惯其实不是一件容易的事情，但是如果一件事觉得有兴趣，可以维持一段时间，但是真的要想坚持下去，需要至少三个月到一年的不断坚持。这个过程将不再是一腔热血能够支撑的了的，而是每天需要忍受不知道写什么的痛苦。但是只要坚持下去，后面就慢慢的觉得写文档是和吃饭睡觉一样的事情了，不会有什么期待和痛苦，而是觉得一件必不可少的事情。

保持乐观与专注

最纯粹的内心才能写出最纯粹的文字，社会的阴暗面或多或少的会影响个人的心态，但是只要保持大脑里接收简单的知识就好了。复杂是客观存在的，而自己可以选择简单。一禅行师在《故道白云》里的有一篇专门写关于吃橘子的专注我很喜欢。

“一个修习专念的人可以从橘子里看到别人看不到的东西。一个留心察觉的人可以看到那棵橘树，春天时橘树的花朵，和滋养橘子的阳光和雨水。细看之下，我们可以看到一万稞导致橘子产生的。看着橘子，一个修习专注的人能看到宇宙间的奥妙和万事万物相互关系。孩子们，我们的日常生活就像橘子一样。就如每个橘里由片片的橘子肉组成，每一天也是由二十四小时组成。一小时就如一片橘子肉。生活了二十四小时就如吃完了全部了橘子肉。我所找到的道路，就是要把每一个小时都活在专注察觉之中，心念永远只投入目前这一刻。与此相反的做法，就是活得糊涂。如果是这样的活着，我们其实不知道自己是活着的。我们没有彻底地去体验生命，因为我的身和心都没有投入此时此处。”

知足常乐

文章不可用贪多，内容也不要想写的没有一点瑕疵。自己写的东西，重要的是给自己查阅，并不是展示给他人。所以不需要多么严格，重要的是有不断变好的信念。其实最开始写的文章以后再看，觉得非常的简单，但是那时候就是这个想法，要学会接纳。重要的是因为这些好的习惯，才有了现在这些高品质的文章。

关于工具

写文档我觉得采用markdown比较好，目前我用的是Typora。云笔记采用的是为知笔记，是需要收费使用的，个人觉得比较纯粹所以用的这个，当然也可以采用其他。图床工具采用的是PicGo。微信公众号排版可以采用md2all。markdown文档的管理在坚果云上。

结语

坚持写文档，并养成习惯，这将会对自己有很大的帮助。希望每个做技术的人都有写文档的习惯，不管是否分享，都值得去做下去。