geeks-dev/php-markdown-extra-extended-stylish

PHP Markdown Extra Extended Stylish

dev-master 2014-02-19 10:52 UTC

This package is not auto-updated.

Last update: 2024-09-28 15:28:56 UTC


README

查看 惊人的演示

支持

Markdown Extra Extended 的分支。

删除

  • 换行符生成 <br />

这是因为错误已被封装。

图标

输入 :(heart):

输出 <span class="glyphicon glyphicon-heart"></span>

输入 [(heart)]

输出 <i class="fa fa-heart"></i>

输入 [(heart,spin,2x)]

输出 <i class="fa fa-heart fa-spin fa-2x"></i>

自定义图标

输入 :(custom|heart,spin,4x):

输出 <span class="custom custom-heart fa-spin fa-4x"></span>

输入 [(custom|heart,spin,4x)]

输出 <i class="custom custom-heart fa-spin fa-4x"></i>

用法

您需要 markdown.phpmarkdown_extended_stylish.php 文件,但只需包含 markdown_extended_stylish.php

require_once('markdown_extended_stylish.php');

// Convert markdown formatted text in $markdown to HTML
$html = MarkdownExtended($markdown);

许可协议

PHP Markdown Extra Extended 采用 MIT 许可协议。有关详细信息,请参阅 LICENSE 文件。

其他信息

基本部分没有改变。我所做的是与现代相匹配的扩展。

哦,对不起。
我的英语不太好。

以下为旧文本

从 PHP Markdown (Extra) 修改语法

除非明确指定,否则现有的 Markdown 标记仍然按原来的方式工作。原始语法在此处文档化。

支持 blockquote 元素的 cite 属性

现在可以在 blockquote 元素上添加可选的 cite 属性。

新的可选语法是

> (cite url) Cited content follows ...

示例

> (http://www.whatwg.org/) Content inside a blockquote must be quoted 
> from another source, whose address, if it has one, 
> may be cited in the `cite` attribute.

将产生以下 HTML

<blockquote cite="http://www.whatwg.org/">
<p>Content inside a blockquote must be quoted 
from another source, whose address, if it has one, 
may be cited in the `cite` attribute.</p>
</blockquote>

从 PME 的破坏性变更

现有的 blockquote 规则和 格式化选项 仍然适用。添加此功能时有一个小的破坏性变更。如果你的引用以 "(" 开头,你需要在初始 ">" 和 "(" 之间至少有两个空格。例如。

>  (Ut brisket flank salami.) Cow cupidatat ex t-bone sirloin id. 
> Sunt flank pastrami spare ribs sint id, nulla nisi.

将产生以下 HTML

<blockquote>
  <p>(Ut brisket flank salami.) Cow cupidatat ex t-bone sirloin id.<br>
  Sunt flank pastrami spare ribs sint id, nulla nisi.</p>
</blockquote>

支持语言类型和交替围栏标记(```)的围栏代码块

现在可以指定代码块的语言类型,并使用交替围栏标记(```),启用与 GFM 相同的语法。

此添加遵循 W3C 的 建议方法 指定语言。

示例

~~~html
<p>Ut brisket flank salami.  Cow cupidatat ex t-bone sirloin id.</p>
~~~

使用替代围栏标记

```html
<p>Ut brisket flank salami.  Cow cupidatat ex t-bone sirloin id.</p>
```

它们都将输出以下 HTML

<pre><code class="language-html">
<p>Ut brisket flank salami.  Cow cupidatat ex t-bone sirloin id.</p>
</code></pre>

支持 figurefigcaption 标签

现在对 HTML5 标签 figurefigcaption 提供了实验性支持。

一个 figure 是一个块级元素,通过将一些其他内容用三个或更多相等号 (=) 包围来创建。

可以添加一个可选的 figure caption 到图例的顶部或底部,紧接在等号之后,用 [] 标记包围。

示例

此示例显示了一个没有标题的 figure

===
![](img/reference.png)
===

本例展示了在内容之前添加标题的图形

=== [A **happy face** is good for web developers]
![](img/reference.png)
===

本例展示了在内容之后添加标题的图形

===
![](img/reference.png)
=== [A **happy face** is good for web developers]