实例简介Markdown格式
简介
Markdown 是一种轻量级标记语言,由John Gruber和Aaron Swartz创建,使其成为可读性最大并可再发行的可输入输出的格式。
Markdown 并不是为了取代 Html,因为根本取代不了。Markdown 的理念是,
能让文档更容易读、写和随意改。HTML 是一种发布的格式,Markdown 是一种书写的格式。
今天,D瓜哥也潮一下,和大家一起来玩转一下Markdown。
最后的善意提醒,Markdown文档的扩展名为md
。
#1到#6
表示标题1到6
示例代码:
1 | # 标题一 |
2 | ### 标题三 |
输出如下:
标题一
标题三
行前四个空格或者一个Tab 表示代码
示例代码:
1 | //由于空格不容易识别,所以,在这里的前面的四个空格使用下划线标识。 |
2 | ____public class HelloWorld { |
3 | ____ public static void main(String[] args) { |
4 | ____ System.out.println("Hello, http://www.diguage.com/"); |
5 | ____ } |
6 | ____} |
输出如下:
1 | public class HelloWorld { |
2 | public static void main(String[] args) { |
3 | System.out.println( "Hello, http://www.diguage.com/" ); |
4 | } |
5 | } |
反斜杠包括
标识行内代码
示例代码:
1 | 先来个`HelloWorld`吧 |
输出如下:
先来个
HelloWorld
吧
>
表示区块
示例代码:
1 | > 这是区块 |
2 | > |
3 | > 第二行区块 |
输出如下:
这是区块
第二行区块
**包括**
表示加粗
示例代码:
1 | **该部分加粗** |
输出如下:
该部分加粗
注:
_粗体_
也能表示加粗
*包括*
表示斜体
示例代码:
1 | *斜体* |
输出如下:
斜体
*
、+
、-
表示无序列表
示例代码:
1 | * 第一个 |
2 | * 第二个 |
3 |
4 | 多一行 |
5 |
6 | * 第三个 |
7 | + 嵌套一 |
8 | + 嵌套二 |
输出如下:
- 第一个
- 第二个
多一行
- 第三个
- 嵌套一
- 嵌套二
注:
在序列中间插入一个空行,转出成HTML,则会多一个
数字+点号
表示有序列表
示例代码:
1 | 1. 第一个 |
2 | 1. 第二个 |
输出如下:
- 第一个
- 第二个
注:
- 如果段的开头就是数字+点号,则在点号之前加
\
进行转义;- 如果想在列表的单项内使用代码,则代码之前必须是 2个Tab 或者 8个空格 ;
- 如果想在列表的单项内使用区块,则
>
之前必须是 1个Tab 或者 4个空格 ,并且前后各一个空行;
链接
链接分为俩种, 行内链接 和 参考链接 。下面分别来说明一下
行内链接
示例代码:
1 | 这是[“地瓜哥”博客网](http://www.diguage.com/ "“地瓜哥”博客网")。 |
输出如下:
这是“地瓜哥”博客网。
注:
链接后面文字,转化成HTML就是title属性,这个是可选的。
参考链接
示例代码:
1 | 这是[“地瓜哥”博客网][1]。 |
2 | [1]: http://www.diguage.com/ "“地瓜哥”博客网" |
输出如下:
这是“地瓜哥”博客网。
隐式链接功能
示例代码:
输出如下:
这是“地瓜哥”博客网。
注:
- 链接后面文字,转化成HTML就是title属性,这个是可选的;
[1]
方括号中,不仅仅可以数字,字母也可以;
图片
图片的表示方法和链接的表示方法一样,也有俩种。分为 行内形似 和 参考形式。下面分别来说明。
行内形式
示例代码:
1 | 下面是地瓜哥的头像: |
2 |
输出如下:
下面是地瓜哥的头像:
参考形式
示例代码:
1 | 下面是D瓜哥的头像: |
2 |
3 | ![D瓜哥][Dgg] |
4 |
输出如下:
下面是D瓜哥的头像:
注:
- 图片的表示方法和链接的表示方法大致相同,只是前面多了一个感叹号。
- 链接后面的文字,转化成HTML标识title属性。该属性可选。
三个以上的*
、-
、_
表示一个分割线。
示例代码:
1 | **** |
2 | ---- |
3 | ____ |
输出如下:
注:
四个
*
很类似加粗,为了防止歧义或者误解,个人还是建议使用----
,简单明了。
表示自动链接
示例代码:
输出如下:
注:
对网址或者电子邮箱都有效。
工具
Windows
- MarkdownPad,没错,这篇文章就是使用这个工具写成的。
- MarkPad,这个工具是开源的,本想支持一下,但是在我电脑上装上了愣是启动不起来。所以,只好放弃。
Linux
- ReText,这个D瓜哥没用过,不做任何评价。
Mac
- Mou,本人没有用过,貌似网友评价很高的!更令人高兴的是,还是国人开发的。实在可喜可贺啊!!
在线版
-
MaHua,国人开发的。在预览的时候,对代码的高亮处理有其诱人,可惜到处之后就木有高亮显示了!算是美中不足吧。
这个工具实在让我太满意,其他的就不推荐了。
吐槽一下
Markdown确实用起来简单方便。但是,经过D瓜哥的简单学习后,还是发现一些问题。如下
- 对代码的高亮实在让人不满意,尤其是不能区别不同编程语言来进行不同的高亮,实在让人郁闷;
- 缺乏对链接的
target
属性的支持,所以有时不想让用户跳出本站,但是点击链接后就直接跳转到其他网站了,这估计会让向D瓜哥这样的站长很郁闷; - 对表格的支持也差强人意,不过Github对Markdown的增强语法可以支持表格了;
特别说明
为了说明Markdown的原生态效果,本文的代码没有使用SyntaxHighlighter进行高亮处理。
参考
原文链接:https://wordpress.diguage.com/archives/28.html
版权声明:非特殊声明均为本站原创作品,转载时请注明作者和原文链接。
您好,我是新手刚刚接触Markdown,也在使用Markdownpad。想请问一下您:代码的语法亮亮是怎么实现的?谢谢
“`这里写语言名称,例如java。这里是代码“`上面这样就可以代码高亮了。我现在不用Markdownpad了,不知道普通版是否支持这种语法。你可以试试Atom,这个编辑器支持我上面说的高亮。