谁适合学习技术写作(Technical Writing)?

有一定技术专业专长,又对写作感兴趣,希望通过互联网达成技术分享、价值实现的作者

为什么建议您使用Markdown来进行技术写作?

可能你 Word、PPT、公众号编辑器,甚至 H5编辑器 都贼溜,我仍然建议你学习一下 Markdown 语法

原因是:

  1. Markdown 语法易学易用,对非编程人员也非常友好,很容易上手,上手后又非常流畅,可以提供特别畅快的内容创作体验,让你文思泉涌,码字停不下
  2. Markdown 语法对结构化写作天然支持,习惯使用 Markdown 写作后,文章结构清晰,读者的阅读体验非常棒
  3. Markdown 的 .MD格式文件为纯文本,通用性、迁移性特别好,众多优秀的编辑器、PKM(个人知识管理)软件,都对 Markdown 有良好的支持。一旦你掌握了 Markdown 语法,熟悉了一两款 Markdown 软件后,就基本可以实现文档创作自由,不再受到创作平台的制约(云写作平台受网络环境、内容限制、运营风险等等,总会让人有些不放心。重要数据还是要有一份完全自己本地的安心。)
  4. Markdown 语法非常适合将创作内容发布到互联网,便于分享传播。无论是写技术博客,还是制作个人网站,甚至制作 App,Markdown 语法都可以大显身手
  5. 很多软件有配套主题,可以一键将您的文章进行漂亮的渲染,颜值党的大福音
  6. 利用笔记软件(Notetaking Apps),可以增强 Markdown 语法的功能性,在 Markdown 的基础上实现双链、大纲、引用等丰富的 PKM (个人知识管理)功能,能帮助你构建属于自己的知识网络

PS,技术写作回报丰厚,国内外技术写作变现平台的生态也越来越好。越来越多的人通过技术写作获得了丰厚的回报。

技术写作发布平台

少数派就是一个非常好的平台,阅读体验非常好,有很多优质的技术文章切实惠及读者,也让优质内容创作者们得到了回报。目前少数派还没有全面支持 Markdown 写作,而是采用了富文本编辑的方式。但也仅需少量操作,就可以将您的 Markdown 内容转换成少数派支持的美文格式了,一点也不复杂

如果您英语水平好,文笔出色,也可以选择 Medium 平台,收益非常可观。Medium 上也有非常多值得学习的技术文章,同样阅读体验很棒

推荐适合上手的 Markdown 编辑利器

  • Markdown文本编辑器,推荐选择 Typora 来上手
 
  • MD 文件管理,知识管理,推荐 Obsidian,对 Markdown 全面支持,尤其是有丰富的插件,允许用户任意订制自己需要的 PKM 特性
 

值得一提的是,Obsidian 和 PKM爱好者有个非常棒的中文 PKM 社区,PKMer.cn,社区中有大量的 Obsidian 使用教程、新手仓库示例、插件,很多Obsidian插件作者都活跃在 PKM 社区。核心团队在开发一款 Thino 插件,也是很有新意,目前处于内测中,接受早鸟订阅,值得关注

  • Markdown 新媒体编辑器推荐:极客编辑器:https://www.geekeditor.com/
 

轻量级的 web 端 Markdown 编辑器,支持一键将 Markdown 内容发布至新媒体平台(如微信公众号、稀土掘金等)。2.0 版本重构中,Markdown 语法的创作体验也会更加出众

参考阅读

  • Markdown Guide(Markdown 指南):https://www.markdownguide.org/
  • 最简Markdown 教程
 
  • Medium推荐阅读文章【Do You Have What It Takes To Be A Technical Writer?
    您具备成为技术作家的条件吗?】:https://readmedium.com/zh/how-to-get-started-as-a-technical-writer-83eac0bca75c