首页 > Web开发, 挨踢(IT) > 实例简介Markdown格式

实例简介Markdown格式

2013年7月16日 发表评论 阅读评论 2,259 人阅读    

简介

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. 第二个

输出如下:

  1. 第一个
  2. 第二个

注:

  1. 如果段的开头就是数字+点号,则在点号之前加\进行转义;
  2. 如果想在列表的单项内使用代码,则代码之前必须是 2个Tab 或者 8个空格
  3. 如果想在列表的单项内使用区块,则>之前必须是 1个Tab 或者 4个空格 ,并且前后各一个空行;

链接

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

行内链接

示例代码:

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

输出如下:

这是“地瓜哥”博客网

注:

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

参考链接

示例代码:

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

输出如下:

这是“地瓜哥”博客网

隐式链接功能

示例代码:

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

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

输出如下:

这是“地瓜哥”博客网

注:

  1. 链接后面文字,转化成HTML就是title属性,这个是可选的;
  2. [1]方括号中,不仅仅可以数字,字母也可以;

图片

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

行内形式

示例代码:

下面是地瓜哥的头像:

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

输出如下:

下面是地瓜哥的头像:

D瓜哥

参考形式

示例代码:

下面是D瓜哥的头像:

![D瓜哥][Dgg]

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

输出如下:

下面是D瓜哥的头像:

D瓜哥

注:

  1. 图片的表示方法和链接的表示方法大致相同,只是前面多了一个感叹号。
  2. 链接后面的文字,转化成HTML标识title属性。该属性可选。

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

示例代码:

****
----
____

输出如下:




注:

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

表示自动链接

示例代码:

<http://www.diguage.com/>

输出如下:

http://www.diguage.com/

注:

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

工具

Windows
  • MarkdownPad,没错,这篇文章就是使用这个工具写成的。
  • MarkPad,这个工具是开源的,本想支持一下,但是在我电脑上装上了愣是启动不起来。所以,只好放弃。
Linux
  • ReText,这个D瓜哥没用过,不做任何评价。
Mac
  • Mou,本人没有用过,貌似网友评价很高的!更令人高兴的是,还是国人开发的。实在可喜可贺啊!!
在线版
  • MaHua,国人开发的。在预览的时候,对代码的高亮处理有其诱人,可惜到处之后就木有高亮显示了!算是美中不足吧。

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

吐槽一下

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

  1. 对代码的高亮实在让人不满意,尤其是不能区别不同编程语言来进行不同的高亮,实在让人郁闷;
  2. 缺乏对链接的target属性的支持,所以有时不想让用户跳出本站,但是点击链接后就直接跳转到其他网站了,这估计会让向D瓜哥这样的站长很郁闷;
  3. 对表格的支持也差强人意,不过Github对Markdown的增强语法可以支持表格了;

特别说明

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

参考

  1. Markdown 快速入门
  2. Markdown 语法说明
  3. 轻量级标记语言


作 者: D瓜哥,https://www.diguage.com/
原文链接:https://wordpress.diguage.com/archives/28.html
版权声明:非特殊声明均为本站原创作品,转载时请注明作者和原文链接。

分类: Web开发, 挨踢(IT) 标签: ,
  1. drunkangle
    2014年8月29日22:24 | #1

    您好,我是新手刚刚接触Markdown,也在使用Markdownpad。想请问一下您:代码的语法亮亮是怎么实现的?谢谢

    • 2014年9月3日09:40 | #2

      “`这里写语言名称,例如java。这里是代码“`上面这样就可以代码高亮了。我现在不用Markdownpad了,不知道普通版是否支持这种语法。你可以试试Atom,这个编辑器支持我上面说的高亮。

  1. 本文目前尚无任何 trackbacks 和 pingbacks.