重新认识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,虽然宰牛刀杀鸡有点浪费,但杀鸡的刀是一定宰不了牛,本质还是权衡学习成本和自身需求。

参考

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,293评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,604评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,958评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,729评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,719评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,630评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,000评论 3 397
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,665评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,909评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,646评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,726评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,400评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,986评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,959评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,197评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,996评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,481评论 2 342

推荐阅读更多精彩内容

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