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

https://zh.wikipedia.org/wiki/Markdown)

# markdown的优缺点
* **优点**
* 语法简洁
* 简单、轻量级
* 标签有行业标准
* 应用广泛(GitHub、Reddit、StackOverFlow、JianShu)
* 相应的工具支持很好。(pandoc、sublime Text 2)
* **缺点**
* 表格实现需要html代码

# markdown基本语法
## 段落
一个段落是由一个以上的连接的行句组成,而一个以上的空行则会划分出不同的段落(空行的定义是显示上看起来像是空行,就被视为空行,例如有一行只有空白和 tab,那该行也会被视为空行),一般的段落不需要用空白或换行缩进。

## 标题
markdown支持两种标题语法,`Setext`和`Atx`形式。
* `Setext`是在标题文字底部用底线的形式,用`=`(1级标题)和`-`(2级标题)。
1级标题
==
2级标题

* `Atx`实在标题文字前面插入`#`,最多可以插入6个`#`,也就是最多支持6级标题。
在文字是`#`,几个`#`代表几级标题(最多支持6级标题)。
# 1级标题
## 2级标题
### 3级标题

>建议在`#`和标题之间建议保留一个字符的空格,这是最标准的 Markdown 写法。
## 字体
* 粗体:文字两头使用2个`*`和`_`进行标记
**粗体**、__粗体__
* 斜体:文字两头使用1个`*`和`_`进行标记
*斜体*、_粗体_

##列表
* **无序列表**

在列表开头添加`*`、`+`或`_`等符号标记。需要注意的是这些符号和文字之间需要添加`空格`,要显示二级列表则在符号前面增加`空格`。

>* 无序列表
>* 无序列表

* **有需列表**

在列表开头依次添加`数字`、`.`、`空格`进行标记,数字可以随便写,markdown可以自动更正。

>1. 有序列表
>2. 有序列表
>2. 有序列表
>2. 有序列表

## 链接
链接分为`内联`和`引用`两种方式。
* 内联
行内形式是直接在后面用括号直接接上链接。
This is an [example link](http://example.com/).
也可以选择性加上title属性。
This is an [example link](http://example.com/ “With a Title”).
* 引用
应用形式的链接让你可以为链接定一个名称(链接名称可以用字母、数字和空格,但是不分大小写),之后你可以在文件的其他地方定义该链接的内容。
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”

## 代码
在一般的段落文字中,你可以使用反引号来标记代码区段,区段内的 &、< 和 > 都会被自动的转换成 HTML 实体,这项特性让你可以很容易的在代码区段内插入 HTML 代码。
``

## 区块引用
在文字使用`>`标记。
>区块引用

## 下划线
在空白行下方输入三个或三个以上`-`、`*`、`_`。


****
___

## 代码
* 行内代码
在代码前后使用反引号进行标记。
``
* 代码块(部分markdown编辑器支撑语法高亮)
在代码块前后使用3个反引号进行标记。
“`

“`

## 图片
图片的语法和链接很像,只是前面多了一个`!`。
* 行内形式(title 是选择性的):
![图片](/path/to/img.jpg “Title”)
* 参考形式:
![图片][id]
[id]: /path/to/img.jpg “Title”

## 表格(有些markdown编辑器不支持)
表示以`|`进行分隔,在表头和数据行中间,可以定义。
#### 表格
| Item | Value | Qty |
| :——– | ——–:| :–: |
| Computer | 1600 USD | 5 |
| Phone | 12 USD | 12 |
| Pipe | 1 USD | 234 |

#参考资料
1. [Markdown 语法说明 (简体中文版)](http://wowubuntu.com/markdown/)
2. [献给写作者的 Markdown 新手指南](http://www.jianshu.com/p/q81RER)
3. [为什么作家应该用 Markdown 保存自己的文稿](http://jianshu.io/p/qqGjLN)
4. [Markdown写作浅谈](http://jianshu.io/p/PpDNMG)
5. [马克飞象](http://maxiang.info/)
6. [三分钟学会书写格式良好的笔记(Markdown)](http://blog.wiz.cn/markdown.html)

markdown使用总结的更多相关文章

  1. NiceMark——我的Markdown编辑器

    NiceMark--我的Markdown编辑器 闲来无事,写了一个Markdown编辑器.基于electron,完全采用Web前段技术(Html,css,JavaScript)实现.代码已托管在Git ...

  2. Markdown 图片助手-MarkdownPicPicker

    title: Markdown 图片助手 v0.1 toc: true comments: true date: 2016-06-04 16:40:06 tags: [Python, Markdown ...

  3. 前端学Markdown

    前面的话   我个人理解,Markdown就是一个富文本编辑器语言,类似于sass对于css的功能,Markdown也可以叫做HTML预处理器,只不过它是一门轻量级的标记语言,可以更简单的实现HTML ...

  4. 好用的Markdown编辑器一览 readme.md 编辑查看

    https://github.com/pandao/editor.md https://pandao.github.io/editor.md/examples/index.html Editor.md ...

  5. mac好用的markdown编辑器

    在刚开始接触markdown的时候,就被吸引了.此后一直在找贴心的好用的markdown编辑器.印象笔记和马克飞象配合着用也是挺好的,唯一的缺点就是比较封闭,发个笔记的链接给同学,还得注册才能看,导致 ...

  6. Markdown学习笔记

    分为两步: 1.阅读Markdown中文官网的文档 2.下载MarkdownPad2将中文官网中文档的例子敲一遍,其中Markdownpad2为官网中推荐的编辑器 备注: 如果只看中文官网文档,不边看 ...

  7. Linux 中优秀的文本化编辑思想大碰撞(Markdown、LaTeX、MathJax)

    这样一个标题可能不太准确,因为确实无法准确地解释什么叫"文本化编辑思想".其实我这篇随笔主要是想探讨 Markdown.LaTeX.MathJax,有兴趣的朋友可以继续往下看,同时 ...

  8. Markdown是怎样接管我的各种的写作工作的

    对于一个程序猿来说,没有什么比单纯的写代码更能让人兴奋了.如果能让你像写代码一样写文档,不用再面对那些繁琐的样式,你会怎么看?它就是Markdown!即使博客园已经有不少介绍的文章了,但是我依然还是不 ...

  9. markdown常用语法总结

    转自markdown示例[模板] 1.1.段落标题 根据原文中的文档标题可以对应设置标题. # 一级标题## 二级标题### 三级标题 效果 => 一级标题 二级标题 三级标题 1.2.斜体.加 ...

  10. 基于 Cmd MarkDown 的 markdown 语法学习

    首先我要打一个属于干货的广告:CmdMarkDown 是非常好用的markdown编辑器软件,支持全平台,由作业部落出品,分为客户端与WEB端两种使用场景. 本篇博客学习的markdown语法都是基于 ...

随机推荐

  1. c++ macro

     C++ Code  12345678910111213141516171819202122232425262728293031   /* version: 1.0 author: hellogise ...

  2. 终端ssh登录mac用shell打包ipa报错:replacing existing signature

    终端ssh登录mac用shell打包ipa报错:replacing existing signature 报错原因:login.keychain被锁定,ssh登录的没有访问权限 解决方法:终端敲入 s ...

  3. Effective C++ -----条款48:认识template元编程

    Template metaprogramming(TMP,模板元编程)可将工作由运行期移往编译期,因而得以实现早期错误侦测和更高的执行效率. TMP可被用来生成“基于政策选择组合”(based on ...

  4. Divide and Conquer:River Hopscotch(POJ 3258)

     去掉石头 题目大意:一群牛在河上的石头上跳来跳去,现在问你如何通过去掉M个石头,使得牛跳过石头的最短距离变得最大? 这一题比较经典,分治法的经典,二分法可以很方便处理这个问题,我们只要明白比较函数这 ...

  5. RSA 加解密转换

    由于项目的原因,原来的项目使用.net 进行开发,现在需要转成java, 所以原来的加解密就成了一个棘手的问题.由于数据使用RSA签名加密,又因为.net 和 Java 加解密算法上的差异,并不能使用 ...

  6. VB中字符串操作函数

    Len Len(string|varname) 返回字符串内字符的数目,或是存储一变量所需的字节数. Trim Trim(string) 将字符串前后的空格去掉 Ltrim Ltrim(string) ...

  7. Struts2应用流程注解

    当Web容器收到请求(HttpServletReques   t)它将请求传递给一个标准的的过滤链包括(ActionContextCleanUp)过滤器. 经过Other filters(SiteMe ...

  8. Web前端开发工程师的就业前景

    Web前端开发工程师的就业前景 Web前端开发工程师是一个全新的职业,在IT行业真正受到重视的时间不超过5年.因此,大家越来越关心web前端工程师前景怎么样?web前端工程师就业如何?Web前端开发是 ...

  9. SQL TO LINQ(Linqer神器)

    此软件可以把SQL语句转换成LINQ语句 首先把Linqer下载到本地, 1.在VS中创建.dbml文件和.cs文件 打开VS,创建一个控制台项目即可,再添加一个dbml项目 2.添加连接数据库 3. ...

  10. Linux将Shelll输出写入到文件

    &>  以覆盖的方式,写入文件 &>> 将输出追加到文件 将命令的正确输出与错误输出都放入文件. /dev/null,垃圾箱. 将无用输出放入垃圾箱. 命令>& ...