Markdown 简洁好用是毋庸置疑的。但是在使用中碰到过以下几个困惑:
第一次想在 wiz 中使用 Markdown 笔记时,查阅 为知笔记 Markdown 新手指南 发现代码的渲染效果挺好,挺喜欢的。可实际上把我在 MarkdownPad2 中写好的笔记拷贝过去时,发现代码的渲染效果和 MarkdownPad2 中一样素净,并没有语法高亮。进而发现两者关于代码的语法定义是有区别的。
不单单代码,在 为知笔记 Markdown 新手指南 中提到的好些特性我在 MarkdownPad2 中并不能使用:
如果你是名程序员,那么可以用 ``` 把代码块包起来,渲染后可以关键字高亮
删除线:在文字前后添加 ~~
目录
在手机上购买 jotterpad 之后,发现代码部分的渲染效果和 MarkdownPad2 也不一样,更加的不起眼,导致最开始时我还以为 jotterpad 不识别代码语法呢。
正文
直到今天(2016年6月1号)才发现,Markdown 是存在标准之乱的。从最早的 Markdown诞生(称为传统 Markdown,Markdown Basics等),流行起来之后各种扩展,在 GitHub 上最盛行的 GitHub Flavored Markdown (GFM), 做标准的 CommonMark。
其中,做标准让大家欣喜,Markdown 发布标准了(借此理解行末两空格的意义),但也遇到了 极大的困难,理解英文有困难的话可以看 Markdown的标准化之路。
应用
关于三款应用:
为知笔记使用哪种标准?在其官网未找到相关说明。猜测至少是以GFM为蓝本的,甚至就是用的GFM。
MarkdownPad2 可以更改“Markdown 处理器”。默认使用第一个
在 jotterpad 的官网提示如下:
JotterPad renders Markdown (CommonMark) syntax.
语法
关于语法(中文):
- 传统 Markdown
- GFM 格式说明
- CommonMark Spec
- * Markdown 书写风格指南
- Markdown标准语法与GitHub Flavored Markdown语法大全
选择
关于 CommonMark:虽然不读英文,想来是撕逼过的。
CommonMark,最早的名字叫 Standard Markdown,后来迫于 Markdown 原作者 John Gruber 的压力而改名。
有人觉得“无规矩不成方圆”,没有标准的话未来发展空间有限;也有同志认为正是因为没有标准,才会出现各种扩展,百花齐放。
扩展阅读:
- Markdown and CommonMark
- 互联网中的左派与右派
其实,操那么多心做什么,作为程序员,哪块用得着拿哪块,用不着的少参与。
争论并不重要,重要的是 选择使用正确的 Markdown Parser
ps 这篇备忘录整理完之后命名为《Markdown 标准之乱》,在半年以后(2016/12/15 16:40:38 )发布时改为现在的名字。内容未做任何修改,我觉得原先的标题是整理的初衷与当时的感慨,但并不切合整理后成稿的内容。况且我现在用 Markdown 基本就是在用 GFM 了,半年前的困扰和选择已然过去了。