Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。 —— 维基百科;
Markdown 是一种轻量级标记语言,让写作者专注于写作而不用关注样式。很多有编程基础的程序员比较喜欢使用Markdown进行编写,github项目中README.md都是markdown编写的;以下我讲述通用的语法,保留各个编辑器通用的,还有很多markdown语法是各个编辑器独有的,大家使用过程中可以注意一下,平时使用mac上的编辑器,也为大家分享一下。
1. 标题
# 一级标题
## 二级标题
### 三级标题
演示图效果:
2. 强调
- 在Markdown中,可以使用 * 或 _ 来表示斜体和加粗。
- 使用一个*或者_来表示斜体,两个来表示加粗。
A: *我是斜体*
B: _我也是斜体_
C:**我是粗体**
D: __我也是粗体__
演示图效果:
- 例子(摘抄于马克飞象"案例,马克飞象是一个很不错的markdown编辑器,为markdown各种类型的语法提供了一个良好的支持)
**马克飞象**是一款专为印象笔记(Evernote)打造的Markdown编辑器,通过精心的设计与技术实现,配合印象笔记强大的存储和同步功能,带来前所未有的书写体验。特点概述:
- **功能丰富** :支持高亮代码块、*LaTeX* 公式、流程图,本地图片以及附件上传,甚至截图粘贴,工作学习好帮手;
- **得心应手** :简洁高效的编辑器,提供[桌面客户端][1]以及[离线Chrome App][2],支持移动端 Web;
- **深度整合** :支持选择笔记本和添加标签,支持从印象笔记跳转编辑,轻松管理。
3. 锚点
markdown会针对每个标题,在解析时都会添加锚点 id,例如:
# 介绍
# 介绍1
那我们就可以使用“[访问介绍标题的锚点](#介绍)”,来定义锚点
测试:
访问介绍标题的锚点;
4. 引用
Markdown 标记区块引用和 email 中用 > 的引用方式类似,只需要在整个段落的第一行最前面加上 > :
演示:
5. 列表
标记通常放在句子最左边,项目标记后面要接一个字符的空格。
- 无序列表:使用星号、加号或是减号作为列表标记
* 我是无序列表A
+ 我是无序列表B
- 我是无序列表C
- 有序列表:使用数字接着一个英文句点
1. 我是无序列表1
2. 我是无序列表2
3. 我是无序列表3
3.代办列表(简书暂不支持此方式)
- [ ] 不勾选
- [x] 勾选
- 补充
如果在列表中使用引用,需要换行缩进,一般为四个空格:
* 演示内容:
> 引用部分1
> 引用部分2
> 引用部分3
> 引用部分4
6. 代码块
使用`包裹代码块,并声明代码块的语言,一般会带有相关的解析插件,对代码进行高亮处理,对代码进行着色。
超链接
方括号显示说明,圆括号内显示网址, Markdown 编辑器会自动把它转成链接;
[我的博客](https://blog.csdn.net/limm33)
[编程者联盟](https://github.com/limm33/ProgrammerLeague/blob/master/ProgrammerLeague.jpg)
[个人博客](http://www.limingming.org)
演示:
7. 图片
图片和超连接语法比较像,可以在方括号前面加一个!就变成了引用图片了;
![编程者联盟](url)
或者:
![卡卡西](/Users/limm/Pictures/火影忍者/30381-106.jpg)
相对路径也可以(./path/*.jpg)这种形式
8. 分割线
使用 3 个以上 - 符号制作分割线:
分割线以上内容
------------------
分割线以下内容
演示:
9. 表格
markdown可以制作表格,方法也很简单
例如:
3 | 3 | 3
-|-|-
3| 3| 3
以上为最基本的结构,‘3’代表你编辑的内容,第一行为表头,但是有的编辑器 - 需要多个,有的需要至少三个,所以布局可以尽量美观:
一列 | 第二列 | 第三列
---------|---------------|----------
值1 | 值2 | 值3
演示:
可以设置对齐方式,使用 :添加在列的左边左对齐,右边为右对齐,两边都添加就是中间对齐:
一列 | 第二列 | 第三列
:---------|---------------:|:----------:
值1 | 值2 | 值3
值3 | 值4 | 值5
演示:
以上为总结的markdown的语法,希望对你的编写有所帮助。