retext代码高亮_实例简介Markdown格式

简介

Markdown 是一种轻量级标记语言，由John Gruber和Aaron Swartz创建，使其成为可读性最大并可再发行的可输入输出的格式。

Markdown 并不是为了取代 Html，因为根本取代不了。Markdown 的理念是，

能让文档更容易读、写和随意改。HTML 是一种发布的格式，Markdown 是一种书写的格式。

今天，D瓜哥也潮一下，和大家一起来玩转一下Markdown。

最后的善意提醒，Markdown文档的扩展名为md。

#1到#6 表示标题1到6

示例代码：

# 标题一

### 标题三

输出如下：

标题一

标题三

行前四个空格或者一个Tab 表示代码

示例代码：

//由于空格不容易识别，所以，在这里的前面的四个空格使用下划线标识。

____public class HelloWorld {

____ public static void main(String[] args) {

____ System.out.println("Hello, http://www.diguage.com/");

____ }

____}

输出如下：

public class HelloWorld {

public static void main(String[] args) {

System.out.println("Hello, http://www.diguage.com/");

}

}

反斜杠包括 标识行内代码

示例代码：

先来个`HelloWorld`吧

输出如下：

先来个HelloWorld吧

> 表示区块

示例代码：

> 这是区块

>

> 第二行区块

输出如下：

这是区块

第二行区块

**包括** 表示加粗

示例代码：

**该部分加粗**

输出如下：

该部分加粗

注：

_粗体_ 也能表示加粗

*包括* 表示斜体

示例代码：

*斜体*

输出如下：

斜体

*、+、- 表示无序列表

示例代码：

* 第一个

* 第二个

多一行

* 第三个

+ 嵌套一

+ 嵌套二

输出如下：

第一个

第二个

多一行

第三个

嵌套一

嵌套二

注：

在序列中间插入一个空行，转出成HTML，则会多一个

数字+点号 表示有序列表

示例代码：

1. 第一个

1. 第二个

输出如下：

第一个

第二个

注：

如果段的开头就是数字+点号，则在点号之前加\进行转义；

如果想在列表的单项内使用代码，则代码之前必须是 2个Tab 或者 8个空格 ；

如果想在列表的单项内使用区块，则>之前必须是 1个Tab 或者 4个空格 ,并且前后各一个空行；

链接

链接分为俩种， 行内链接 和 参考链接 。下面分别来说明一下

行内链接

示例代码：

这是[“地瓜哥”博客网](http://www.diguage.com/ "“地瓜哥”博客网")。

输出如下：

注：

链接后面文字，转化成HTML就是title属性，这个是可选的。

参考链接

示例代码：

这是[“地瓜哥”博客网][1]。

[1]: http://www.diguage.com/ "“地瓜哥”博客网"

输出如下：

隐式链接功能

示例代码：

这是[“地瓜哥”博客网][]。

[“地瓜哥”博客网]: http://www.diguage.com/ "“地瓜哥”博客网"

输出如下：

注：

链接后面文字，转化成HTML就是title属性，这个是可选的；

[1]方括号中，不仅仅可以数字，字母也可以；

图片

图片的表示方法和链接的表示方法一样，也有俩种。分为 行内形似 和 参考形式。下面分别来说明。

行内形式

示例代码：

下面是地瓜哥的头像：


输出如下：

下面是地瓜哥的头像：

参考形式

示例代码：

下面是D瓜哥的头像：

![D瓜哥][Dgg]

[Dgg]: https://secure.gravatar.com/avatar/8bd9c131364e4dd7cac8442986af4383.png?s=240 "D瓜哥"

输出如下：

下面是D瓜哥的头像：

注：

图片的表示方法和链接的表示方法大致相同，只是前面多了一个感叹号。

链接后面的文字，转化成HTML标识title属性。该属性可选。

三个以上的*、-、_ 表示一个分割线。

示例代码：

****

----

____

输出如下：

注：

四个*很类似加粗，为了防止歧义或者误解，个人还是建议使用----，简单明了。

表示自动链接

示例代码：

输出如下：

注：

对网址或者电子邮箱都有效。

工具

Windows

MarkdownPad，没错，这篇文章就是使用这个工具写成的。

MarkPad，这个工具是开源的，本想支持一下，但是在我电脑上装上了愣是启动不起来。所以，只好放弃。

Linux

ReText，这个D瓜哥没用过，不做任何评价。

Mac

Mou，本人没有用过，貌似网友评价很高的！更令人高兴的是，还是国人开发的。实在可喜可贺啊！！

在线版

MaHua，国人开发的。在预览的时候，对代码的高亮处理有其诱人，可惜到处之后就木有高亮显示了！算是美中不足吧。

这个工具实在让我太满意，其他的就不推荐了。

吐槽一下

Markdown确实用起来简单方便。但是，经过D瓜哥的简单学习后，还是发现一些问题。如下

对代码的高亮实在让人不满意，尤其是不能区别不同编程语言来进行不同的高亮，实在让人郁闷；

缺乏对链接的target属性的支持，所以有时不想让用户跳出本站，但是点击链接后就直接跳转到其他网站了，这估计会让向D瓜哥这样的站长很郁闷；

对表格的支持也差强人意，不过Github对Markdown的增强语法可以支持表格了；

特别说明

为了说明Markdown的原生态效果，本文的代码没有使用SyntaxHighlighter进行高亮处理。

参考