Markdown简介

明哥品书 2016-11-18

展开全文

Markdown简介

　　　Markdown 是一种轻量级的(优雅的)「标记语言」它目前被越来越多的写作爱好者、撰稿者、程序员所使用。Markdown 的语法十分简单，它用简洁的语法代替排版。而不像一般我们用的字处理软件 Word 或 Pages 有大量的排版、字体设置。它使我们专心于码字，用「标记」语法，来代替常见的排版格式。 Markdown语言所编辑的文件后缀名为「.md」。

Markdown官网

http:///projects/markdown/basics

工具

Windows环境推荐用推荐使用MarkdownPad这款工具,理由就不多说了

下载地址:http://www./

在 Mac OS X 上，我强烈建议你用 Mou 这款免费且十分好用的 Markdown 编辑器，

常用语法

1. 标题

语法说明:如果一段文字被定义为标题，只要在这段文字前加 # 号即可。

以此类推，总共六级标题

        #  This is an H1
        ## This is an H2
        ###### This is an H6

效果:

This is an H1

This is an H2

This is an H6

一级标题也可以在第二行加入「=」号

A First Level Header
=====================

效果:

A First Level Header

二级标题也可以在第二行加入「-」号

A Second Level Header
----------------------

效果:

A Second Level Header

2. 列表

语法说明:

在文字前加上 +、- 或 * 即可变为无序列表

在文字前加 1. 2. 3. 符号即可以变成有序列表

无序列表

+ Candy 
- Gum 
* Booze

无序效果:

Candy
Gum
Booze

有序列表

1. Red
2. Green
3. Blue

有序效果:

Red
Green
Blue

3. 引用

语法说明: 如果你需要引用一小段别处的句子，那么就要用引用的格式。

> 我是引用

效果:

我是引用
引用和标题组合使用
> 引用
> > ##我来自火星
> > > # 我来自火星
效果:
引用
我来自火星
我来自火星

4. 链接与图片

语法说明: 插入链接与插入图片的语法很像，区别在一个 !号

注意:标记前必须顶格或前面接内容「"」号内容为连接或图片的标题

[GITHUB](https://github.com/LiHengofChina  "HHA")

链接效果:

GITHUB

![Mou icon](http:///Mou_128.png)

图片效果:

5. 分隔线、加粗与倾斜

分隔线说明:只需要另起一行，连续输入三个星号 *** 即可。

***

效果:

加粗说明:用两个「*」号或「_」号包括一段文字

Use two asterisks for **strong emphasis**. Or, if you prefer, __use two underscores instead__.

效果:

Use two asterisks for strong emphasis. Or, if you prefer, use two underscores instead.

倾斜说明:用一个「*」或「_」号包括一段文字

Some of these words *are emphasized*.Some of these words _are emphasized also_.

效果:

Some of these words are emphasized. Some of these words are emphasized also.

6. 代码框

说明: 用「`」号将代码引起来

`printf()`

效果:

printf()

6. 表格

方法一:Markdown的表格语法

| Tables        | Are           | Cool  | 
| ------------- |-------------  | ----- |  
| col 3 is      | right-aligned | $1600 |  
| col 2 is      | centered      |   $12 |  
| zebra stripes | are neat      |    $1 |

效果: 注意,在MarkdownPad程序中无法正常显示,但是GITHUB中可以正常显示,这是由于各种软件对于Mardown语法支持的程序不同决定的

Tables	Are	Cool
col 3 is	right-aligned	$1600
col 2 is	centered	$12

| zebra stripes | are neat | $1 |

方法二:Markdown支持html，所以我们可以用html来写表格。

<table class="table table-bordered table-striped table-condensed" >
   <tr>
      <th>John</th>
      <th>Smith</th>
      <th>123 Main St.</th>
      <th>Springfield</th>
   </tr>
   <tr> 
      <td><code>System.out.println("123")</code></td>
      <td>Jones<I>要设为斜体的内容</I></td>
      <td></td> 
      <td>Dover</td> 
   </tr>
   <tr>
      <td>Jim</td>
      <td>Baker</td>
      <td>789 Park Ave.</td>
      <td>Lincoln</td>
   </tr>
</table>

效果: 注意,在MarkdownPad程序中无法正常显示,但是GITHUB中可以正常显示,这是由于各种软件对于Mardown语法支持的程序不同决定的

John	Smith	123 Main St.	Springfield
`System.out.println("123")`	Jones要设为斜体的内容		Dover
Jim	Baker	789 Park Ave.	Lincoln

　　小技巧指北:

　　关于如果让段首缩进这件事?

　　Markdown 奉行的是样式和内容分开的哲学。所以不会处理缩进的问题，我们可以把输入法切换成全角,然后按下空格来达到"段首缩进"的效果，快捷键Shift+space。

总结

　　　到这里Markdown的语法到这里就介绍完了,总共不超过10个语法规则,一旦熟悉这种语法规则，会有一劳永逸的效果。另外注意,不同的软件对Markdown语法的支持程序不一定完整,表现出来的细微差异不必过于追究。除外除非是做研究，不要当码乙己，祝大家工作愉快！(笔者注:本文也是用Markdown完成。)

文章来源链接：https://github.com/LiHengofChina/java-notes/blob/master/IDE/Markdown/Markdown.md