首页 > 技术文章 > Markdown

hero4china 2017-03-14 21:13 原文

 Markdown基本语法

简介

本文介绍Markdown的基本使用方法:

  • 使用标题
  • 加粗、斜体
  • 分割线
  • 列表
  • 引用

我写博客一般将可以独立的内容分节,每一节有一个标题,标题的字体应该与正文的字体有点区别。两个相邻节之间使用分割线分割开。需要强调或者特别说明的地方使用 粗体 或者 斜体 。

列表用于列举可以并列的内容,这样看起来比较清晰。

引用,可以用来做注意说明,也可以用来写引用的内容,比如别人说过的话。

下面我们一一说明这些格式的语法。


使用标题

比如,我开篇写的“简介”这两个字,就是标题格式,使用方式如下:

## 简介
  • 1
  • 1

Markdown可以使用#来标示标题。一个#后面跟的内容是一级标题,一般一级标题是文章的大标题。两个#,后面跟的内容是二级标题,依次类推。正文中的标题,我一般用二级标题。

下面是例子:

# 一级标题
## 二级标题
### 三级标题
  • 1
  • 2
  • 3
  • 1
  • 2
  • 3

加粗、斜体

对指定文本进行加粗:

**文本加粗**
  • 1
  • 1

得到:

文本加粗

对指定文本置斜:

*文本置斜*
  • 1
  • 1

得到:

文本置斜

对指定文本加粗并且置斜

***文本加粗、置斜***
  • 1
  • 1

得到:

文本加粗、置斜


分割线

分割线的语法:

空一行后,使用三个以上的短线、星号、或者下划线

我一般在两个小节之间使用分割线。


---

***

___
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

上面的例子中有三个分割线生成,如下所示:

 


 




列表

列表有两种,一种是无序列表,使用一些图标标记,没有序号;一种是有序列表,使用数字标记。

无序列表

无序列表语法:

在‘-’号之后加一个空格,再跟列表项的内容。

例如:

- 花生
- 香蕉
- 菠萝
  • 1
  • 2
  • 3
  • 1
  • 2
  • 3

得到:

  • 花生
  • 香蕉
  • 菠萝

也可以使用多级无序列表,只需要在低层列表符号之前再加一个空格。

- 水果
 - 香蕉
 - 菠萝
- 衣服
 - 上衣
 - 裤子
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

得到:

  • 水果 
    • 香蕉
    • 菠萝
  • 衣服 
    • 上衣
    • 裤子

有序列表

有序列表语法:

在数字和“.”号之后加一个空格,再跟列表项的内容。

例如:

1. 把冰箱门打开
2. 把大象装进去
3. 把冰箱门带上
  • 1
  • 2
  • 3
  • 1
  • 2
  • 3

得到:

  1. 把冰箱门打开
  2. 把大象装进去
  3. 把冰箱门带上

也可以使用分级,使用方法与无序列表类似:在低层列表前再加一个空格。

1. 把冰箱门打开
2. 把大象装进去
 1. 给大象喝点水
 2. 把大象的被子放进去
3. 把冰箱门带上
  • 1
  • 2
  • 3
  • 4
  • 5
  • 1
  • 2
  • 3
  • 4
  • 5
  1. 把冰箱门打开
  2. 把大象装进去 
    1. 给大象喝点水
    2. 把大象的被子放进去
  3. 把冰箱门带上

引用

引用的语法:

在“>”符号之后跟一个空格,然后添加引用内容。

例如:

> 这是引用的文字啊!!!
  • 1
  • 1

得到如下结果:

这是引用的文字啊!!!


 

总结

本文主要介绍了使用Markdown写博客的基本语法,只需要记住几个符号,我们就可以写出漂亮的博客了。

简介

前文 Markdown基本语法 中介绍了Markdown的基本语法,知道那些基本的语法,实际上已经可以写纯文本的博客了。对我们这群写代码的人或者将要写代码的人来说,貌似这些还不够,我们还希望能插入图片、代码、表格、超链接!此文分别介绍怎么在Markdown中用这些特性。


表格

如下表:

姓名年龄学历
张三 16 高中
李四 17 大学
王五 18 研究生

 

他的Markdown文本是:

| 姓名 | 年龄 | 学历 |
|:--- |:---:| ---:|
| 张三 | 16 | 高中 |
| 李四 | 17 | 大学 |
| 王五 | 18 | 研究生|
  • 1
  • 2
  • 3
  • 4
  • 5
  • 1
  • 2
  • 3
  • 4
  • 5

从上面的例子,我们可以看出来,Markdown生成的表格是使用冒号来选择左 :---、右 ---: 或者居中 :---:对齐的。其中代码中第二行中的短线的数量可以根据美观来定。


代码

比如插入下面一段代码:

#include <iostream>
using namespace std;
int main(){
  cout << "hello markdown" << endl;
  return 0;
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

可以在Markdown编辑器中输入下图中内容:

输入代码段

语法规则是:

在需要高亮的代码块的前一行及后一行使用三个反引号“`”,同时第一行反引号后面表面代码块所使用的语言

在行内的代码可以使用两个反引号包住,例如 printf() 就是输入 `printf()` 得到的。


插入图片

纯文本方式插入图片

例如:

![hust](http://www.hust.edu.cn/images/logo.gif)
  • 1
  • 1

得到的结果是:

hust

语法是:

感叹号 ! 后跟一个中括号[],中括号中可以添加说明文字,后面再添加一个小括号(),小括号中输入插入图片的网址

使用CSDN的Markdown编辑器插入

也可以在CSDN的Markdown编辑器的工具栏中选择插入图片按钮:

插入图片

选择上传图片

上传图片

然后选择图片后,点集上传,确定,一气呵成~~


超链接

可以在文中直接加入超链接

中括号后跟一个小括号,中括号中加入提示的文字,圆括号中加入的是超链接

例如

[bendanban的博客](http://blog.csdn.net/bendanban)
  • 1
  • 1

得到的结果是:

bendanban的博客

也可以使用类似论文中引用的格式

在正文中使用两个相邻的两个中括号。第一个中括号中添加提示文字,第二个中括号中添加一个id,可以使数字,字母等。 
在文本的最后添加类似参考文献的格式:一个中括号,后跟一个冒号,然后再跟连接地址。第一个中括号中填入id。

例如:

[提示文字][1]
[1]: http://blog.csdn.net/bendanban 
  • 1
  • 2
  • 1
  • 2

得到的结果是:

提示文字

还可以直接在正文中使用两个尖括号将超链接包括起来

例如:

<http://blog.csdn.net/bendanban> or <sawpara@126.com>
  • 1
  • 1

得到的结果是:

http://blog.csdn.net/bendanban or sawpara@126.com


总结

本文主要介绍了在Markdown中如何使用表格、代码、图片、超链接来丰富自己的博客。表格是竖线和冒号的组合;代码是左引号三个,或者一个;图片使用感叹号,中括号,小括号;超链接使用中括号、小括号、尖括号等。


PS:欢迎大家批评指正!

<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default"></script>

然后,再使用Tex写公式。$$公式$$表示行间公式,本来Tex中使用\(公式\)表示行内公式,但因为Markdown中\是转义字符,所以在Markdown中输入行内公式使用\\(公式\\),如下代码:

 

http://blog.csdn.net/xiahouzuoxin/article/details/26478179

http://blog.csdn.net/bendanban/article/details/44196101

http://blog.csdn.net/bendanban/article/details/44221279 

http://blog.163.com/goldman2000@126/blog/static/167296895201221242646561/

Latex所有常用数学符号整理

这段时间用Latex很多,常常需要查阅相关特殊的符号,这里做一个整理,也方便大家查阅。

摘自:《一份不太简短的LATEX2介绍》或112分钟学会LATEX2    原版作者:Tobias Oetiker

推荐阅读