关于Markdow语法

将一些关于Markdown语法（包括sublime设置）记录下来，方便以后查阅。

1 sublime 编辑器配置

（1）Package Control是一个开源的用于插件管理的插件，在为Sublime安装其他插件之前，需要安装它。它有两种安装方式Simple和Manual。此处我们选择simple方式来安装。

从菜单 View - Show Console 或者 ctrl + ~ 快捷键，调出 console。将以下 Python 代码粘贴进去并 enter 执行，不出意外即完成安装。以下提供 ST3 和 ST2 的安装代码：

Sublime Text 3：

import urllib.request,os,hashlib; h = ‘2915d1851351e5ee549c20394736b442’ + ‘8bc59f460fa1548d1514676163dafc88’; pf = ‘Package Control.sublime-package’; ipp = sublime.installed_packages_path(); urllib.request.install_opener( urllib.request.build_opener( urllib.request.ProxyHandler()) ); by = urllib.request.urlopen( ‘http://packagecontrol.io/’ + pf.replace(’ ', ‘%20’)).read(); dh = hashlib.sha256(by).hexdigest(); print(‘Error validating download (got %s instead of %s), please try manual install’ % (dh, h)) if dh != h else open(os.path.join( ipp, pf), ‘wb’ ).write(by)

Sublime Text 2：

import urllib2,os,hashlib; h = ‘2915d1851351e5ee549c20394736b442’ + ‘8bc59f460fa1548d1514676163dafc88’; pf = ‘Package Control.sublime-package’; ipp = sublime.installed_packages_path(); os.makedirs( ipp ) if not os.path.exists(ipp) else None; urllib2.install_opener( urllib2.build_opener( urllib2.ProxyHandler()) ); by = urllib2.urlopen( ‘http://packagecontrol.io/’ + pf.replace(’ ', ‘%20’)).read(); dh = hashlib.sha256(by).hexdigest(); open( os.path.join( ipp, pf), ‘wb’ ).write(by) if dh == h else None; print(‘Error validating download (got %s instead of %s), please try manual install’ % (dh, h) if dh != h else ‘Please restart Sublime Text to finish installation’)

按下enter之后可以看见编辑器最下面有提示正在安装，安装成功后会弹出一个README的文档。此时我们调出Command Paletter（Ctrl+Shift+P），输入pci选择install package，enter后会加载repository中的插件。搜索需要的插件按enter，等待几分钟，插件就安装好了。

（2）安装可选插件
再次按下ctrl+shift+P打开快速菜单，键入’pcip’,回车，等待数据更新，完成后会主动显示软件列表。 在里面输入以下软件名称并回车进行安装：

Markdown Editing // Markdown编辑和语法高亮支持
Markdown Preview// Markdown导出html预览支持
快捷键：
preference -> package settings -> markdown editing ->settings user里面添加：

[
{ “keys”: [“alt+m”], “command”: “markdown_preview”, “args”: { “target”: “browser”} }
]

auto-save // 可自定义的自动保存功能

前两个是标准的markdown编辑与预览工具，第三个是实现实时预览的关键,耐心等待操作完成，之后关闭并重新打开Sublime Text 3。

2 Markdow 语法

转自http://www.cnblogs.com/hnrainll/p/3514637.html

1. 标题设置（让字体变大，和word的标题意思一样）
   在Markdown当中设置标题，有两种方式：
   第一种：通过在文字下方添加“=”和“-”，他们分别表示一级标题和二级标题。
   第二种：在文字开头加上 “#”，通过“#”数量表示几级标题。（一共只有1~6级标题，1级标题字体最大）

2. 块注释（blockquote）
   第一种：通过在文字开头添加“>”表示块注释(>和文字之间添加五个blank时，块注释的文字会有变化)

example

example

第二种：tab键 + 4个空格

    example

3. 斜体
   将需要设置为斜体_的文字两端使用1个“*”或者“”夹起来

4. 粗体
   将需要设置为粗__体__的文字两端使用2个“*”或者“_”夹起来

5. 无序列表
   在文字开头添加(, +, and -)实现无序列表。但是要注意在(, +, and -)和文字之间需要添加空格。（建议：一个文档中只是用一种无序列表的表示方式）

6. 有序列表
   使用数字后面跟上句号。（还要有空格）

7. 链接（Links）
   Markdown中有两种方式，实现链接，分别为内联方式和引用方式。
   内联方式：This is an [example link](http://example.com/).
   引用方式：
   I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].

[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ “Yahoo Search”
[3]: http://search.msn.com/ “MSN Search”

8. 图片（Images）
   图片的处理方式和链接的处理方式，非常的类似。
   内联方式：![alt text](\images\profile\.jpg)
   引用方式：
   ![alt text][id]

[id]: /path/to/img.jpg "Title"

9. 代码（HTML中所谓的Code）
   实现方式有两种：
   第一种：简单文字出现一个代码框。使用<blockquote>。（不是单引号而是左上角的ESC下面~中的）

第二种：漂亮的代码框，还可以自动高亮

int i = 0;
i = 1;
for (int i = 0; i < 100; i ++)
{
	printf("helo markdown!\n")
}

第三种：使用Tab和四个空格。

    int i = 0;
    i = 1;
    for (int i = 0; i < 100; i ++)
    {
    	printf("helo markdown!\n")
    }

10. 脚注（footnote）
    实现方式如下：
    hello¹
    hello²

11. 下划线
    在空白行下方添加三条“-”横线。（前面讲过在文字下方添加“-”，实现的2级标题）

12. 其他 尖括号 http://ibruce.info bu.ru@qq.com
    可指定编程语言, <>代表左右大括号
    <% codeblock [title] [lang:language] [url] [link text] %>
    code snippet
    <% endcodeblock %>

注释: Html的注释# <!-- 注释 -->
转义字符 Markdown中的转义字符为\, 转义的有:
\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号

---

1. https://www.baidu.com ↩︎

2. hi ↩︎