markdown 入门简明指南
标题
标题是每篇文章必备而且最常用的格式。
在Markdown中,如果想将一段文字定义为标题,只需要在这段文字前面加上 #,再在 # 后加一个空格即可。还可增加二、三、四、五、六级标题,总共六级,只需要增加 # ,增加一个 # ,标题字号相应降低一级。如下:
一号标题
二号标题
三号标题
四号标题
五号标题
六号标题
空行
对于空行,需要在编辑模式下空整整一行,才能被认定为是空行,但是对于空一行和空两行在预览模式下没有任何的区别。
换行
对于编辑模式中即使使用回车键换行,实际显示的是一个小空格编辑模式中由于单行位置不够导致的换行,在实际显示中会由于显示页面的大小自行更改。 正式的换行应该为在两个空格后使用换行符(Enter键)
强调
markdown中使用两个连等号括起来的部分表示强调其中的内容强调
==强调==
编辑器
对于编辑器我觉得最好的编辑器是Atom,这个编辑器是Github公司开发的并且支持开源,而且有相当多的插件,支持代码表格,代码向下滚动,导出为PDF格式,插入图片,插入代码自动提醒等功能。更主要的是在国外有大量的用户,并且能够对其进行及时维护。
列表
- 无序列表
列表格式也很常用,它可以让你的文稿变得井井有条。在Markdown 中,你只需要在文字前面加上-就可以了;如果你希望是有序列表,在文字前面加上 1. 2. 3. 即可。 注意-和1.与文字之间要保留一个字符的空格
- 列表1
- 列表1.1.1(转到下一行后紧接着上一行开头使用Tab- 列表1.1.1即可)
- 列表1.1.1.1.1(同上,是一种递归的过程)
- 列表1.1.1.1(同上,是一种递归的过程)
- 列表1.1 (在一行的开头Tab- 列表1.1)
- 列表2
- 列表3
- 有序列表
- 对于列表和标题也可以相互嵌套使用,具体是先使用列表样式在使用标题样式
- 列表1
- 列表1.3.1
- 列表1.3.2
- 列表1.3.2.1 第四级
- 列表1.1 注意只能使用1.或者2.类似标注,1.1这样标注不支持
- 列表1.2 注意1.和2.的效果相同,形式相同即可,与具体数字符号无关
- 列表1.3
- 列表2
引用
如果你需要在文稿中引用一段别处的句子,那么就要用到「引用」格式。
在引用文字前加上 > 并与文字保留一个字符的空格,即可。
Github about Me https://github.com/Asurada2015
粗体和斜体
Markdown 的粗体和斜体也非常简单:
用两个 * 包含一段文本就是粗体的语法;
用一个 * 包含一段文本就是斜体的语法。 斜体
斜体
粗体
粗体
代码为
*斜体*
## *斜体*
**粗体**
## **粗体**
对于斜体和粗体都可以进行嵌套使用,并且符号与文本之间无需空格
代码
代码使用三个顿号包括的代码块包围起来 例如:
这是代码
```
这是代码
```
数学公式
例如:
E=mc2
```math
E = mc^2
```
中划线
中划线
代码为
~~中划线~~
下划线
++下划线++
++下划线++
水平分界线
---
链接与图片
链接
在 Markdown 中,插入链接只需要使用 [显示文本](链接地址)
即可。
图片
在 Markdown 中,插入图片只需要使用 ![显示文本](图片链接地址)
即可。
注意:
插入图片和链接的语法很像,只是前面多了一个 !感叹号
插入图片
![图片名称](图片地址)
分割线
分割线的语法只需要另起一行,连续输入三个星号 *** 即可分割两段文字内容。
***
或者
---
表格
当你需要在Markdown中键入表格
参考
待办与清单
待办事项和清单在日常工作、生活中经常被使用。
在Markdown中,你只需要在待办的事项文本或者清单文本前加上- [ ]、- [x]即可。
- <input type="checkbox" class="task-list-item-checkbox sync-line" data-line="154"> 表示未完成,- [x] 表示已完成。
注:键入字符与字符之间都要保留一个字符的空格
To-do List
-[x] 已完成项目1
-[x] 已完成事项1
-[x] 已完成事项2
-[ ] 待办事项1
-[ ] 待办事项2
- [x] 已完成项目1
- [x] 已完成事项1
- [x] 已完成事项2
- [ ] 待办事项1
- [ ] 待办事项2
-[x] 已完成项目1
-[x] 已完成事项1
-[x] 已完成事项2
-[ ] 待办事项1
-[ ] 待办事项2
- 已完成项目1
- 已完成事项1
- 已完成事项2
- 待办事项1
- 待办事项2
流程图
在Markdown中,一段流程图语法以三个上撇号开头,以三个上撇号结尾。
在三个上撇号后另起一行,书写graphXX,用以确定将要绘制的流程图及其类型(XX表示流程图类型)。
流程图分为竖向和横向两大类,竖向包括自上而下和自下而上两种顺序,横向包括从右到左和从左到右两种顺序。
其对应语法分别为:graph TB/graph BT/graph RL/graph LR。
TB - top bottom(自上而下) BT - bottom top(自下而上) RL - right left(从右到左) LR - left right(从左到右)
简单示例
自上而下
graph TB
A-->B
```
graph TB
A-->B
```
自下而上
graph BT
A-->B
```
graph BT
A-->B
```
自左向右
graph LR
A-->B
```
graph LR
A-->B
```
自右向左
graph RL
A-->B
```
graph RL
A-->B
```
具体示例
流程图
graph TD
A[Christmas方括号]-->B(Go shopping圆括号)
B-->|选择括号|C{Let me think}
C---|直线| D[Laptop]
C-->|箭头| E[iPhone]
C-->|标签三| F[Car]
```
graph TD
A[Christmas方括号]-->B(Go shopping圆括号)
B-->|选择括号|C{Let me think}
C---|直线| D[Laptop]
C-->|箭头| E[iPhone]
C-->|标签三| F[Car]
```
For More
更多流程图语法
甘特图
注意这里的冒号,逗号都要使用英文的符号的形式
gantt
dateFormat YYYY-MM-DD
title 产品计划表
section 初期阶段
明确需求:2016-03-01, 10d
section 中期阶段
跟进阶段:2016-03-11, 18d
section 后期阶段
走查阶段:2016-03-20, 23d
```
gantt
dateFormat YYYY-MM-DD
title 产品计划表
section 初期阶段
明确需求:2016-03-01, 10d
section 中期阶段
跟进阶段:2016-03-11, 18d
section 后期阶段
走查阶段:2016-03-20, 23d
```
For More
更多甘特图语法
数据流图例子
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
流程图例子
sequenceDiagram
participant Alice
participant Bob
Alice->John: Hello John, how are you?
loop Healthcheck
John->John: Fight against hypochondria
end
Note right of John: Rational thoughts <br/>prevail...
John-->Alice: Great!
John->Bob: How about you?
Bob-->John: Jolly good!
```
sequenceDiagram
participant Alice
participant Bob
Alice->John: Hello John, how are you?
loop Healthcheck
John->John: Fight against hypochondria
end
Note right of John: Rational thoughts <br/>prevail...
John-->Alice: Great!
John->Bob: How about you?
Bob-->John: Jolly good!
```
甘特图例子
dateFormat YYYY-MM-DD
title Adding GANTT diagram functionality to mermaid
section A section
Completed task :done, des1, 2014-01-06,2014-01-08
Active task :active, des2, 2014-01-09, 3d
Future task : des3, after des2, 5d
Future task2 : des4, after des3, 5d
section Critical tasks
Completed task in the critical line :crit, done, 2014-01-06,24h
Implement parser and jison :crit, done, after des1, 2d
Create tests for parser :crit, active, 3d
Future task in critical line :crit, 5d
Create tests for renderer :2d
Add to mermaid :1d
gantt
dateFormat YYYY-MM-DD
title Adding GANTT diagram functionality to mermaid
section A section
Completed task :done, des1, 2014-01-06,2014-01-08
Active task :active, des2, 2014-01-09, 3d
Future task : des3, after des2, 5d
Future task2 : des4, after des3, 5d
section Critical tasks
Completed task in the critical line :crit, done, 2014-01-06,24h
Implement parser and jison :crit, done, after des1, 2d
Create tests for parser :crit, active, 3d
Future task in critical line :crit, 5d
Create tests for renderer :2d
Add to mermaid :1d
参考资料
有道云笔记Markdown教程
- Jquery ajax调用后台aspx后台文件方法(不是ashx)
- [原创]x.509证书在WCF中的应用(CS篇)
- tomcat
- 快速入门系列--WebAPI--01基础
- 分析程序员到底是不是吃青春饭
- Jquery dom搜索之siblings()方法
- 汽车黑科技!想想以后不是我们亲自驾驶汽车还是蛮开心的
- 快速入门系列--CLR--02多线程
- JavaScript之将JS代码放在什么位置最合适
- 快速入门系列--TSQL-01基础概念
- 初识javascript
- [原创]x.509证书在WCF中的应用(Web/IIS篇)
- Javascript之Dom学习
- 考试备战系列--软考--01基础架构概念
- JavaScript 教程
- JavaScript 编辑工具
- JavaScript 与HTML
- JavaScript 与Java
- JavaScript 数据结构
- JavaScript 基本数据类型
- JavaScript 特殊数据类型
- JavaScript 运算符
- JavaScript typeof 运算符
- JavaScript 表达式
- JavaScript 类型转换
- JavaScript 基本语法
- JavaScript 注释
- Javascript 基本处理流程
- Javascript 选择结构
- Javascript if 语句
- Javascript if 语句的嵌套
- Javascript switch 语句
- Javascript 循环结构
- Javascript 循环结构实例
- Javascript 跳转语句
- Javascript 控制语句总结
- Javascript 函数介绍
- Javascript 函数的定义
- Javascript 函数调用
- Javascript 几种特殊的函数
- JavaScript 内置函数简介
- Javascript eval() 函数
- Javascript isFinite() 函数
- Javascript isNaN() 函数
- parseInt() 与 parseFloat()
- escape() 与 unescape()
- Javascript 字符串介绍
- Javascript length属性
- javascript 字符串函数
- Javascript 日期对象简介
- Javascript 日期对象用途
- Date 对象属性和方法
- Javascript 数组是什么
- Javascript 创建数组
- Javascript 数组赋值与取值
- Javascript 数组属性和方法