Markdown入门学习小结

Markdown常用语法

Markdown是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成格式丰富的HTML页面。 —— [ 维基百科 ]

基础语法

• 目录

  • 使用[TOC]即可提取文章中的标题组成文章目录。

• 标题

  • 在文字写书写不同数量的#可以完成不同的标题。

  • 等号及减号也可以进行标题的书写，不过只能书写二级标题，并且需要写在文字的下面，减号及等号的数量不会影响标题的基数。

• 标题

  • 无序列表的使用，在符号“-”后加空格使用。

  • 如果要控制列表的层级，则需要在符号“-”前使用空格。

  • 有序列表的使用，在数字及符号“.”后加空格几个，有序列表如果要区分层级，也可以在数字前加空格。

• 引用

  • 引用的格式是使用符号“>”后面书写文字， 即可以使用引用。

• 粗体与斜体

  • 粗体的使用是在需要加粗的文字前后各加两个”*”，而斜体的使用则是在需要斜体的文字前后各加一个”*”，如果要使用斜体加粗，那么就是在需要操作的文字前后各加三个“*”。

• 添加注脚

  • 使用如下形式产生注脚：
    A[^demo]
    [^demo]:注脚内容

• 链接与图片

  • 在文中直接加链接，中括号中是需要添加链接的文字，圆括号中是需要添加的链接，如下：
    [link_text](http://example.com/ "optional title")

  • 有序列表的使用，在数字及符号“.”后加空格几个，有序列表如果要区分层级，也可以在数字前加空格。
    [link_text][id][id]: http://example.com/ "optional title here"

  • 为输入的URL或邮箱自动创建链接，如[e-mail]。在文中直接引用链接，直接使用尖括号，把链接加入到尖括号中就可以实现，如下：
    <http://example.com/> 或者 <[e-mail]>

  • 插入互联网上图片，格式如下：
    ![这里写图片描述](http://img3.douban.com/mpic/s1108264.jpg) 或者 ![这里写图片描述][jane-eyre-douban]
[jane-eyre-douban]:http://img3.douban.com/mpic/s1108264.jpg

• 代码块

  • 用TAB键起始的段落，会被认为是代码块

  • 如果在一个行内需要引用代码，只要用反引号“`”引起来就好

• 分割线与删除线

  • 可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，同时需要在分隔线的上面空一行。

  • 删除线的使用，在需要删除的文字前后各使用两个符合“~”

• 代码块与语法高亮

  • 在需要高亮的代码块的前一行及后一行使用三个反引号“`”，同时第一行反引号后面表面代码块所使用的语言

• 表格

  • 可以使用冒号来定义表格的对齐方式，写法如下：

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

• LaTex数学公式

  • 使用MathJax渲染LaTex 数学公式，详见[math.stackexchange.com]
    行内公式，数学公式为：
    $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$
    块级公式：
    $$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$
    更多LaTex语法请参考这儿。

• UML图

  • 可以渲染序列图：
    关于 序列图 语法，参考这儿

  • 或者流程图：
    关于 流程图 语法，参考这儿

• 转义字符

  • 在特殊字符，如*、[、>等前面加\可使特殊格式字符转换为正常字符打出（有序列表符号如1.，须在.前加\）。
• 小型文本
  
  • 语法如下：
    <small>文本内容</small>

更多语法说明请参考：
Markdown官方网站：http://daringfireball.net/projects/markdown/
Markdown中文语法：http://www.appinn.com/markdown/
Markdown扩展语法：https://github.com/trentm/python-markdown2/wiki/wiki-tables

Markdown编辑器推荐

在线Markdown编辑器

CSDN：http://write.blog.csdn.net/mdeditor
马克飞象：https://maxiang.io/
小书匠：http://markdown.xiaoshujiang.com/
Editor.md：https://pandao.github.io/editor.md/
Cmd Markdown：https://www.zybuluo.com/mdeditor
Mahua：http://mahua.jser.me/

Markdown编辑器客户端

马克飞象：
https://pan.baidu.com/s/1sl7tx29#list/path=%2F
https://chrome.google.com/webstore/detail/marxico/kidnkfckhbdkfgbicccmdggmpgogehop
Haroopad：
http://pad.haroopress.com/user.html
Atom：
https://atom.io/
Editor.md:
https://github.com/pandao/editor.md/archive/master.zip

编辑器常用快捷键

加粗 Ctrl + B \
斜体 Ctrl + I \
引用 Ctrl + Q \
插入链接 Ctrl + L \
插入代码 Ctrl + K \
插入图片 Ctrl + G \
提升标题 Ctrl + H \
有序列表 Ctrl + O \
无序列表 Ctrl + U \
横线 Ctrl + R \
撤销 Ctrl + Z \
重做 Ctrl + Y

Word 文件转换为 Markdown

本章节转载自(在Ubuntu 14.04上亲测可用，感谢原作者的分享)：
http://wenzhixin.NET.cn/2014/01/03/convert_word_to_markdown

Ubuntu系统中，将 Word 文件转换为 Markdown 文件方法如下：

第一步：安装 unoconv 和 pandoc
sudo apt-get install unoconv pandoc

第二步：将 word 文件转换 html
unoconv -f html -o file.html file.docx

• f html：指定我们要转为 html 格式（format）
• o file.html：表示输出（output）的文件名为 file.html
• file.docx：表示要转换的文件为 file.docx

第三步：将 html 转换为 markdown
pandoc -f html -t markdown -o file.md file.html

• f html：指定我们要从什么文件（from）转换
• t markdown：指定我们要转为 markdown 格式（to）
• o file.md：表示输出（output）的文件名为 file.md
  file.html：表示要转换的文件为 file.html

第四步：将图片拷贝到 images 中

转换出来后会有很多图片，需要将图片拷贝到 images 文件夹中， 然后再单独上传images中的文件到博客中，这样就可以把我们Word文档分享到博客了，比如CSDN博客。