markdown使用总结
# 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使用总结的更多相关文章
- NiceMark——我的Markdown编辑器
NiceMark--我的Markdown编辑器 闲来无事,写了一个Markdown编辑器.基于electron,完全采用Web前段技术(Html,css,JavaScript)实现.代码已托管在Git ...
- Markdown 图片助手-MarkdownPicPicker
title: Markdown 图片助手 v0.1 toc: true comments: true date: 2016-06-04 16:40:06 tags: [Python, Markdown ...
- 前端学Markdown
前面的话 我个人理解,Markdown就是一个富文本编辑器语言,类似于sass对于css的功能,Markdown也可以叫做HTML预处理器,只不过它是一门轻量级的标记语言,可以更简单的实现HTML ...
- 好用的Markdown编辑器一览 readme.md 编辑查看
https://github.com/pandao/editor.md https://pandao.github.io/editor.md/examples/index.html Editor.md ...
- mac好用的markdown编辑器
在刚开始接触markdown的时候,就被吸引了.此后一直在找贴心的好用的markdown编辑器.印象笔记和马克飞象配合着用也是挺好的,唯一的缺点就是比较封闭,发个笔记的链接给同学,还得注册才能看,导致 ...
- Markdown学习笔记
分为两步: 1.阅读Markdown中文官网的文档 2.下载MarkdownPad2将中文官网中文档的例子敲一遍,其中Markdownpad2为官网中推荐的编辑器 备注: 如果只看中文官网文档,不边看 ...
- Linux 中优秀的文本化编辑思想大碰撞(Markdown、LaTeX、MathJax)
这样一个标题可能不太准确,因为确实无法准确地解释什么叫"文本化编辑思想".其实我这篇随笔主要是想探讨 Markdown.LaTeX.MathJax,有兴趣的朋友可以继续往下看,同时 ...
- Markdown是怎样接管我的各种的写作工作的
对于一个程序猿来说,没有什么比单纯的写代码更能让人兴奋了.如果能让你像写代码一样写文档,不用再面对那些繁琐的样式,你会怎么看?它就是Markdown!即使博客园已经有不少介绍的文章了,但是我依然还是不 ...
- markdown常用语法总结
转自markdown示例[模板] 1.1.段落标题 根据原文中的文档标题可以对应设置标题. # 一级标题## 二级标题### 三级标题 效果 => 一级标题 二级标题 三级标题 1.2.斜体.加 ...
- 基于 Cmd MarkDown 的 markdown 语法学习
首先我要打一个属于干货的广告:CmdMarkDown 是非常好用的markdown编辑器软件,支持全平台,由作业部落出品,分为客户端与WEB端两种使用场景. 本篇博客学习的markdown语法都是基于 ...
随机推荐
- 如何限制一个类只在堆上分配和栈上分配(StackOnly HeapOnly)
[本文链接] http://www.cnblogs.com/hellogiser/p/stackonly-heaponly.html [题目] 如何限制一个类只在堆上分配和栈上分配? [代码] C+ ...
- zookeeper部署及集群测试
zookeeper部署及集群测试 环境 三台测试机 操作系统: centos7 ; hostname: c1 ; ip: 192.168.1.80 操作系统: centos7 ; hostname: ...
- (转)C++0x语言新特性一览
转自:http://blog.csdn.net/zwvista/article/details/2429781 原文请见http://en.wikipedia.org/wiki/C%2B%2B0x. ...
- ACM/ICPC 之 Kruskal范例(ZOJ1203-POJ1861(ZOJ1542))
两道最小生成树范例,Kruskal解法-以边为主体扩展最小生成树,需要利用并查集. ZOJ1203-Swordfish 题意:求n个给定平面坐标的城市中的一条平面距离上的最短路长(保留两位小数) 题解 ...
- [转]AndroidStudio导出jar包
原文链接:http://blog.csdn.net/hjq842382134/article/details/38538097# 1. 不像在Eclipse,可以直接导出jar包.AndroidStu ...
- 20145213《Java程序设计》实验二Java面向对象程序设计实验报告
20145213<Java程序设计>实验二Java面向对象程序设计实验报告 实验内容 初步掌握单元测试和TDD 理解并掌握面向对象三要素:封装,继承,多态 初步掌握UML建模 熟悉S.O. ...
- ajax加载模块实时刷新的原理
var loadMenu = function(data) { var trs = template.render('menu-list-temp', {'list': data}); ...
- 地图API文档
目录 腾讯地图API 2 1.API概览... 2 1.1 WebService API(官网注明是beta版本,可能不稳定,慎用):... 2 1.2 URL API:... 2 1.3 静态图AP ...
- ios 横竖屏通知
屏幕切换时,会发送一个通知.只要注册一个通知: [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(do ...
- c++中有些重载运算符为什么要返回引用
事实上,我们的重载运算符返回void.返回对象本身.返回对象引用都是可以的,并不是说一定要返回一个引用,只不过在不同的情况下需要不同的返回值. 那么什么情况下要返回对象的引用呢? 原因有两个: 允许进 ...