重新认识Markdown
最近在调研文档写作工具,对 Markdown 有了少量新的思考。
Markdown 的优势
毫无疑问,Markdown 是流行的,个人认为有以下几个起因:
- 容易上手,设计得对新手非常友好,把最常用的十几个样式抽离出来,可以满足日常90%的编写场景
- 社区支持,如Github,Hexo等,国内的博客平台CSDN,简书等也都支持了
- 工具链完善,VS Code,Sublime等几乎所有的编辑器都支持Markdown扩展,在线网站,笔记工具,GitBook等等,可选择的编写工具非常多
Markdown 的劣势
- 复杂格式(例如表格、图片标题)支持不够。
- 没有预留扩展语法,导致不同网站、工具各自扩展产生了很多方言(参考Lisp)。
- 没有统一标准
社区有不少人意识到问题,其中就有 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,尽管宰牛刀杀鸡有点白费,但杀鸡的刀是肯定宰不了牛,本质还是权衡学习成本和自身需求。
参考
- Asciidoc简介
- Why You Shouldn’t Use “Markdown” for Documentation
- Markdown 的设计是有很多问题的……
说明
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是摆设,本站源码仅提供给会员学习使用!
7. 如遇到加密压缩包,请使用360解压,如遇到无法解压的请联系管理员
开心源码网 » 重新认识Markdown
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是摆设,本站源码仅提供给会员学习使用!
7. 如遇到加密压缩包,请使用360解压,如遇到无法解压的请联系管理员
开心源码网 » 重新认识Markdown