- 如何写作
- 为什么写作
- 用什么写作
- 在哪里写作
- 参考文档
如何写作
关于写作,我们为什么要写作,这是一个前提。
为什么写作
无论是否是技术人员,我觉得都应该坚持写作。写作带给你的是思维的总结,因为有些事情你只是去想,貌似是很简单。当你去深入思考,其实又是另一个境界。我觉得写作能帮助到我最大的一点是,理清思路。
关于其他,我也比较推荐刘未鹏的两篇博客:
- 为什么你应该(从现在开始就)写博客
- 书写是为了更好的思考
程序员是理科出生,写文章是文科的特征。但是程序员养成写作的习惯,对编程也是很用用处的,比如:
- 写文章和写代码最核心的共同之处在于它们都需要清晰思考的能力。好代码与好文章一样都需要言简意赅,不然就会浪费 CPU 资源或人的精力。
- 软件工程师应该写作因为现在开发协作变得越来越重要。不论是 GitHub 评论、代码注释,还是技术文档都需要清晰准确的文字。良好的写作能力方便了人们之间的交流,使得项目更好地运行下去。
- 即使没人读你的文章,写作的过程也是有益无害。它帮助你理清思路,明确对于某个问题的看法,加强或削弱你的某种观点。把凌乱的想法汇聚成精简的文字非常有价值。
用什么写作
Markdown是我极力推崇的一种通用格式。
但是目前存在多种解释器,导致语法有些混乱,但是熟悉标准的语法,依然能够写好文章。
说几点常用的:
- 删除线: 需要删除的内容前后添加
~~
。 - 强制断行: 正常,回车后形成的断行,不会被 Markdown 解析为断行,需要在断行前面段落后加两个空格或者写入
<br/>
标签。 - 水平分割线: 三个以上的星号,减号,或者下划线,除了空格,不允许出现其它符号。
-----
。
在哪里写作
小时候我们常常使用的是笔和纸,形式多为日记。其实日记并没有什么不好,但是大多数人应该和我应该,会把日记写成流水账,没有太大的意义。
现在是互联网的时代,手机和电脑可以替代我们完成输入,并且记录的形式也多样化,除了文字还可以记录声音,图片和视频。
如果是个人的记录,我比较喜欢使用云笔记,比如印象笔记或者为知笔记。设置一个访问密码,以防无意被他人阅读。
技术性的文章,我更喜欢以博客的形式去发布,一方面会有知识积累的成就感,另一方面也可以与他人交流。博客可以自己搭建,比如github+jekyll,或者使用简书这样的web服务。
参考文档
- Markdown 标准格式
- 为什么软件工程师应该养成写作的习惯?
- You Should Write Blogs
- 技术文章的写作技巧