惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

Martin Fowler
Martin Fowler
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
雷峰网
雷峰网
J
Java Code Geeks
G
Google Developers Blog
博客园 - 司徒正美
The GitHub Blog
The GitHub Blog
L
LangChain Blog
人人都是产品经理
人人都是产品经理
GbyAI
GbyAI
Vercel News
Vercel News
S
SegmentFault 最新的问题
Engineering at Meta
Engineering at Meta
H
Hackread – Cybersecurity News, Data Breaches, AI and More
云风的 BLOG
云风的 BLOG
F
Fortinet All Blogs
Y
Y Combinator Blog
博客园_首页
Last Week in AI
Last Week in AI
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
罗磊的独立博客
A
About on SuperTechFans
B
Blog
Microsoft Security Blog
Microsoft Security Blog

少数派

派早报:Google 发布 Fitbit Air 等 - 少数派 「新人报到」確認需求,再開始 - 少数派 从 SOLO 独立开发者社区,我看到了越来越多开发者开始做自己的产品 - 少数派 我怎么管理那些"不常做,但总会忘"的生活事项 - 少数派 人形机器人量产元年,数据才是具身智能的“生死线” - 少数派 BuhoLaunchpad 高度还原 Mac 启动台:开发历程与思考 - 少数派 五年陪伴依然不舍,DIY 换壳后让罗技 MX Master 3 继续服役 - 少数派 新玩意 240|少数派的编辑们最近买了啥? - 少数派 一日一技|为什么你应该关闭 iOS 的键盘声音 - 少数派 我做了个插件和 Skills,一键提取任何网站的设计规范 Design.md - 少数派 住在三四线城市的你,该开始录播客了 - 少数派 甘南秘境,大白高国 - 少数派 AI的审美:谁让把我变成川内倫子 - 少数派 返工怎能不烦恼,打工人片单总有一部是你的「嘴替」 - 少数派 为了让「上厕所」更健康,我做了一个小工具 - 少数派 AI + Skill,能够让生成的文章去除 AI 味吗? - 少数派 新玩意|韶音OpenDots ONE 耳夹式耳机 - 少数派 《美满》| 在每一个春天的晚上相爱(362) - 少数派 新玩意|优篮子 PS01 MagSnap 磁吸支架 - 少数派 自我整合手记 | 我开始早睡了:用稳定规则,为自由托底 - 少数派 用龙虾(OpenClaw)两个多月,我最深的12个体会 - 少数派 听歌时间到,12 张你可能错过的 2025 华语乐坛好专辑 - 少数派 承诺能追吗 - 少数派 macOS 26启动台没了? 我做了个不一样的App启动器 - Keboard - 少数派 《四海为家的人》| INTJ对话INTJ(361) - 少数派 你发过的那些黑历史,是时候一次清干净了 - 少数派 新玩意:安安静静玩,越玩越专注:计客密码机 - 少数派 iPad 用户首次体验 Android 平板:vivo Pad6 Pro - 少数派 数据逻辑强 - 少数派 极北行+ | 一路向北,探访日本至北之地 | 001 - 少数派
从Markdown 语法开始,学习技术写作 - 少数派
2023-12-19 · via 少数派

谁适合学习技术写作(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