重新认识Markdown

最近在调研文档写作工具,对 Markdown 有了一些新的思考。

Markdown 的优势

毫无疑问,Markdown 是流行的,个人认为有以下几个原因:

  1. 容易上手,设计得对新手非常友好,把最常用的十几个样式抽离出来,可以满足日常90%的编写场景
  2. 社区支持,如Github,Hexo等,国内的博客平台CSDN,简书等也都支持了
  3. 工具链完善,VS Code,Sublime等几乎所有的编辑器都支持Markdown扩展,在线网站,笔记工具,GitBook等等,可选择的编写工具非常多

Markdown 的劣势

  1. 复杂格式(例如表格、图片标题)支持不够。
  2. 没有预留扩展语法,导致不同网站、工具各自扩展产生了很多方言(参考Lisp)。
  3. 没有统一标准

社区有不少人意识到问题,其中就有 Jeff Atwood 牵头,联合 Stack Overflow、Github、Reddit 的一些员工发起了 Standard Markdown 项目,希望将 Markdown 标准化。 没想到项目起步遇到的最大阻力是 Markdown 的创建者 John Gruber,John 很不满意 Jeff 在未充分沟通的情况下宣称自己的项目是“Standard”,经过一番争吵,Jeff 把项目改名为 Common Markdown ,John 也没有加入项目。这个 Common Markdown 至今也没有被广发采纳。
另外,我觉 GitBook 多少沾了 Git 的光,DocBook 肯定更胜一筹。

使用误区

在使用 Hexo 写博客的过程中,我养成了一个不太好的习惯,就是痴迷于扩展,Hexo本身通过扩展丰富了 Markdown 的功能,但当我想要在简书、知乎发布同一文章时,可移植性就成了阻碍。
另外,嵌入 Html 解决复杂格式问题同样不是明智的选择,这相当于把样式带入了内容。

重新认识 Markdown

首先,不要过度依赖 Markdown,通过扩展,Markdown确实能支持很多功能,但这些东西更像是平台的特有功能,而不是 Markdown 本身。其次,认识 Markdown 的使用场景,大部分文章的排版都不会很复杂,Markdown基本能hold住,再复杂就应该用 Sphinx 或者 Asciidoc之类的工具,如果还不能满足,再用 LaTeX,虽然宰牛刀杀鸡有点浪费,但杀鸡的刀是一定宰不了牛,本质还是权衡学习成本和自身需求。

参考

©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

  • 最近遇到一些问题,就是团队中会有些伙伴踩得坑的收集问题或者有些较为复杂的业务需求文档共享上成本较高,所以考虑弄...
    tobAlier阅读 4,047评论 0 5
  • 本文详细讲解了 Gitbook 生成电子书的完整过程,内容包括:安装、命令、配置、文档结构、生成电子书、部署。限于...
    静默虚空阅读 11,493评论 9 138
  • 关于Markdown 一整个学期下来,我觉得让我收获最大之一的是学会markdown语言。我们平常都是使用Word...
    Dacade阅读 1,116评论 0 2
  • 最近发现了了一个不错的AndroidStudio主题,整体配色淡雅又不失炫酷活泼,包括GUI和Schema以及lo...
    木水Code阅读 237评论 0 1
  • 爱,我们总认为是一个名词,是一种状态,而其实,它是一个动词,是一种行为! 1. 我们从来都不缺爱,只是缺少感受...
    陶_c253阅读 301评论 0 0

友情链接更多精彩内容