Markdown的各类扩展

时间 2019-11-07

原文原文链接

刚开始接触markdown的时候，以为好简单好方便，随着使用的深刻，发现markdown好像在不少地方有不少不一样的实现，语法特性各不相同，顿时陷入迷茫。原文：Markdown的各类扩展php

标准markdown的语法：http://daringfireball.net/projects/markdown/syntaxhtml

PHP Markdown Extra

Markdown的php解析与实现，而且增长了许多有用的扩展。PHP Markdown Extra其中几个比较重要的改进有：git

支持在html块元素中插入markdown语法
支持为一些元素添加id或class，好比为header添加id属性，用带锚点的连接导航。例如：

[Link back to header 1](#header1)

Header 1            {#header1}
========

## Header 2 ##      {#header2}

支持元素包括header、code block、link、imagegithub

支持将代码块用`或者~包起来，这样能够避免一些二义，还能够为代码块添加id或class

~~~~~~~~~~~~~~~~~~~~~~~~~~~~ {.html #example-1}
<p>paragraph <b>emphasis</b>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

支持手写的表格：

| Function name | Description                    |
| ------------- | ------------------------------ |
| `help()`      | Display the help window.       |
| `destroy()`   | **Destroy your computer!**     |

支持dl和dt在markdown中的对应语法
支持脚注引用

That's some text with a footnote.[^1]

[^1]: And that's the footnote.

支持专有名词abbr
避免下划线出如今单词中间，致使斜体输出

Maruku

在"始做俑者PHP Markdown Extra"后，不少基于Ruby的Markdown解释器开始浮现。其中，Maruku号称：ruby

支持原生Markdown
支持全部PHP Markdown Extra的特性
支持新的元数据语法，实际上就是给元素添加属性的能力
支持公式格式输出

Maruku的语法详见这里markdown

不过，该项目已经中止维护了。ui

kramdown

一样是ruby开发的解释器，kramdown吸收了Maruku几乎全部的特色，功能更为强大。其中有特色的功能有：this

改进了一些二义语法
引入EOB标记^做为块元素的分隔符
手写table的语法更增强大一些，支持table中的header和footer
一样支持ALD(Attribute List Definitions属性列表定义)
还支持注释，以及在转化时配置一些转化选项

Github-Page推荐使用这个解释器.net

RDiscount

RDiscount又是一个基于Ruby开发的解释器，不过它是基于Discount的语法移植的，因此语法规则须要参考Discount。其语法支持几种上面没有提到过的特性：code

文本居中，即输出<center>
图片大小定义![dust mite](http://dust.mite =150x150)
输出alpha列表：<ol type='a'></ol>

Redcarpet

Redcarpet是一个转化库，能够在标准Markdown的基础上，配置一些额外的功能：

单词中间的_不处理
转化PHP-Markdown风格的手写表格
转化PHP-Markdown风格的带包含的代码块，也可禁用标准markdown的代码块语法
自动link生成
删除线支持：~~good~~
高亮标签<mark></mark>经过==highlighted==输出
引用标签<q></q>经过"quote"输出
转化PHP-Markdown风格脚注
一些二义性的约束支持

Github支持

Github Page对于上述的基于Ruby的markdown是支持的，从这里能够看到。另外，Github对于Issue、comments等，还定义了GFM(GitHub Flavored Markdown)，其中的语法通常基原本源于上面的提到的东西。除此以外，github还支持一些额外的特性：

支持把列表变成带勾选框的任务列表

- [x] @mentions, #refs, [links](), **formatting**, and <del>tags</del> are supported 
- [x] list syntax is required (any unordered or ordered list supported) 
- [x] this is a complete item 
- [ ] this is an incomplete item

站内对分支、问题、用户等对象的直接引用
表情