markdown基本语法

Markdown 是一种方便记忆、书写的纯文本标记语言,用户可以使用这些标记符号以最小的输入代价生成极富表现力的文档:譬如您正在阅读的这份文档。

Markdown 为记录思想和分享知识提供更专业的工具。 可以使用 Markdown:

  • 整理知识,学习笔记
  • 发布日记,杂文,所见所想
  • 撰写发布技术文稿(代码支持)
  • 撰写发布学术论文(LaTeX 公式支持)

什么是 Markdown

Markdown 是一种方便记忆、书写的纯文本标记语言,用户可以使用这些标记符号以最小的输入代价生成极富表现力的文档:譬如您正在阅读的这份文档。它使用简单的符号标记不同的标题,分割不同的段落,粗体 或者 斜体 某些文字,更棒的是,它还可以

标题

在想要设置为标题的文字前面加#来表示
一个#是一级标题,二个#是二级标题,以此类推。支持六级标题。

注:标准语法需要在#后跟个空格再写文字。

示例:

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

效果如下:

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

字体

  • 加粗
    要加粗的文字左右分别用两个*号包起来
  • 斜体
    要倾斜的文字左右分别用一个*号包起来
  • 斜体加粗
    要倾斜和加粗的文字左右分别用三个*号包起来
  • 删除线
    要加删除线的文字左右分别用两个~~号包起来

示例:

这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
这是加删除线的文字

效果如下:
这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
这是加删除线的文字

引用

在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>>
直到n个

示例:

这是引用的内容

这是引用的内容

这是引用的内容

效果如下:

这是引用的内容

这是引用的内容

这是引用的内容

分割线

三个或者三个以上的 - 或者 * 都可以。

示例:

—-



效果如下:




可以看到,显示效果是一样的。

图片

语法:

图片alt

图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加

示例:

blockchain

效果如下:
blockchain

超链接

语法:
超链接名
title可加可不加

示例:

hexo
github

效果如下:
hexo
github

注:Markdown本身语法不支持链接在新页面中打开,如果想要在新页面中打开的话可以用html语言的a标签代替。

超链接名

示例
Github

列表

  • 无序列表
    语法:
    无序列表用 - + * 任何一种都可以
  • 列表内容
  • 列表内容
  • 列表内容

注意:- + * 跟内容之间都要有一个空格

  • 列表内容
  • 列表内容
  • 列表内容
  • 有序列表
    语法:
    数字加点

1.列表内容
2.列表内容
3.列表内容

注意:序号跟内容之间要有空格

效果如下:

  1. 列表内容
  2. 列表内容
  3. 列表内容
  • 列表嵌套

上一级和下一级之间敲三个空格即可

  • 一级无序列表内容

    • 二级无序列表内容
    • 二级无序列表内容
    • 二级无序列表内容
  • 一级无序列表内容

    1. 二级有序列表内容
    2. 二级有序列表内容
    3. 二级有序列表内容
  1. 一级有序列表内容

    • 二级无序列表内容
    • 二级无序列表内容
    • 二级无序列表内容
  2. 一级有序列表内容

    1. 二级有序列表内容
    2. 二级有序列表内容
    3. 二级有序列表内容

表格

语法:

表头 表头 表头
内容 内容 内容
内容 内容 内容

第二行分割表头和内容。
-有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
注:原生的语法两边都要用 | 包起来。此处省略

示例:

姓名 技能 排行
刘备 大哥
关羽 二哥
张飞 三弟

效果如下:

姓名 技能 排行
刘备 大哥
关羽 二哥
张飞 三弟

代码

语法:
单行代码:代码之间分别用一个反引号包起来
代码内容

代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行
(

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
  代码...
代码...
代码...
(```)


注:为了防止转译,前后三个反引号处加了小括号,实际是没有的。这里只是用来演示,实际中去掉两边小括号即可。

示例:
单行代码
> `create database hero;`

代码块

> (```)
> function fun(){
> echo "这是一句非常牛逼的代码";
> }
> fun();
> (```)

效果如下:
单行代码
`create database hero;`
代码块

function fun(){
echo "这是一句非常牛逼的代码";
}
fun();

### 流程图

### 制作一份待办事宜 [Todo 列表](https://www.zybuluo.com/mdeditor?url=https://www.zybuluo.com/static/editor/md-help.markdown#13-待办事宜-todo-列表)

- [ ] 支持以 PDF 格式导出文稿
- [ ] 改进 Cmd 渲染算法,使用局部渲染技术提高渲染效率
- [x] 新增 Todo 列表功能
- [x] 修复 LaTex 公式渲染问题
- [x] 新增 LaTex 公式编号功能

### 书写一个质能守恒公式[^LaTeX]

$$E=mc^2$$

### 高亮一段代码[^code]

```python
@requires_authorization
class SomeClass:
pass

if __name__ == '__main__':
# A comment
print 'hello world'

高效绘制 流程图

1
2
3
4
5
6
7
8
st=>start: Start
op=>operation: Your Operation
cond=>condition: Yes or No?
e=>end

st->op->cond
cond(yes)->e
cond(no)->op

高效绘制 序列图

1
2
3
Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob-->Alice: I am good thanks!

高效绘制 甘特图

1
2
3
4
5
6
7
8
9
10
11
12
13
title 项目开发流程
section 项目确定
需求分析 :a1, 2016-06-22, 3d
可行性报告 :after a1, 5d
概念验证 : 5d
section 项目实施
概要设计 :2016-07-05 , 5d
详细设计 :2016-07-08, 10d
编码 :2016-07-15, 10d
测试 :2016-07-22, 5d
section 发布验收
发布: 2d
验收: 3d

绘制表格

项目 价格 数量
计算机 $1600 5
手机 $12 12
管线 $1 234

总而言之,不同于其它 所见即所得 的编辑器:你只需使用键盘专注于书写文本内容,就可以生成印刷级的排版格式,省却在键盘和工具栏之间来回切换,调整内容和格式的麻烦。Markdown 在流畅的书写和印刷级的阅读体验之间找到了平衡。 目前它已经成为世界上最大的技术分享网站 GitHub 和 技术问答网站 StackOverFlow 的御用书写格式。


LaTeX. 支持 LaTeX 编辑显示支持,例如:$\sum_{i=1}^n a_i=0$, 访问 MathJax 参考更多使用方法。
code. 代码高亮功能支持包括 Java, Python, JavaScript 在内的,四十一种主流编程语言。

本文总阅读量

评论

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×