文章目录
  1. 1. 简介
  2. 2. 区块元素
  3. 3. 区段元素
  4. 4. 其他
  5. 5. Markdown 免费编辑器
  6. 6. 参考

最近才使用github+octopress搭建了自己的个人blog,新建日志的时候会生成MD文件,而编辑MD文件需要使用markdown语法。就决定简单学习一下它的基本语法。可能本文更多的记录,讲解就会比较少,只是为了方便自己以后编辑MD文件。

简介

Markdown 的目标是实现「易读易写」,成为一种适用于网络的书写语言。

兼容HTML。不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。但是在 HTML 区块标签间的 Markdown 格式语法将不会被处理。

HTML 的区段(行内)标签如 <span>、<cite>、<del> 可以在 Markdown 的段落、列表或是标题里随意使用。

区块元素

  1. 段落和换行

    一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。普通段落不该用空格或制表符来缩进。

  2. 标题

    类 Setext:用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),任何数量的 = 和 - 都可以有效果

    This is an H1
    =============
    
    This is an H2
    -------------
    

    类 Atx 形式:在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶

    # 这是 H1
    
    ## 这是 H2
    
    ###### 这是 H6     
    
  3. 区块引用 Blockquotes

    每行的最前面加上 >
    区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 >
    
    > This is the first level of quoting.
    >
    > > This is nested blockquote.
    >
    > Back to the first level.
    
  4. 列表

    无序列表:使用星号、加号或是减号作为列表标记

    *   Red
    *   Green
    *   Blue
    

    有序列表:使用数字接着一个英文句点

    1.  Bird
    2.  McHale
    3.  Parish
    
  5. 代码区块

    <pre><code> 标签来把代码区块包起来
    
    建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以
    
  6. 分隔线

    你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。
    

区段元素

  1. 链接

    链接文字都是用 [方括号] 来标记

    行内式:在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可

    This is [an example](http://example.com/ "Title") inline link.
    
    [This link](http://example.net/) has no title attribute.
    

    参考式:在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记

    This is [an example][id] reference-style link.
    
  2. 强调

    使用星号()和底线(_)作为标记强调字词的符号,被 包围的字词会被转成用 标签包围,用两个 * 或 包起来的话,则会被转成

    *single asterisks*
    
    _single underscores_
    
    **double asterisks**
    
    __double underscores__
    

    如果 和 _ 两边都有空白的话,它们就只会被当成普通的符号。*

  3. 代码

    如果要标记一小段行内代码,你可以用反引号把它包起来(`)

    Use the `printf()` function.
    

    如果要在代码区段内插入反引号,你可以用多个反引号来开启和结束代码区段

    ``There is a literal backtick (`) here.``
    
  4. 图片

    >行内式:
    
     ![Alt text](/path/to/img.jpg)
    
     ![Alt text](/path/to/img.jpg "Optional title")
    >参考式:
    
     ![Alt text][id]
    

其他

  1. 自动链接

    支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接。

    <http://example.com/>
    
  2. 反斜杠

    利用反斜杠来插入一些在语法中有其它意义的符号。例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 标签),你可以在星号的前面加上反斜杠:

    \*literal asterisks\*
    

    Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号

    \   反斜线
    `   反引号
    *   星号
    _   底线
    {}  花括号
    []  方括号
    ()  括弧
    #   井字号
    +   加号
    -   减号
    .   英文句点
    !   惊叹号
    
  3. 表格

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

    效果如下:

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

Markdown 免费编辑器

Windows 平台

MarkdownPad
MarkPad

Linux 平台

ReText

Mac 平台

Mou

在线编辑器

Markable.in
Dillinger.io

浏览器插件

MaDe (Chrome)

高级应用

Sublime Text 2 + MarkdownEditing / 教程

参考

Markdown 语法说明

文章目录
  1. 1. 简介
  2. 2. 区块元素
  3. 3. 区段元素
  4. 4. 其他
  5. 5. Markdown 免费编辑器
  6. 6. 参考