Markdown的基础使用

本文演示了Markdown的一些基础语法,均为经常使用的一些例子。

如有错误,还请留言指正,谢谢!🙂

标题

#号加空格跟随文本信息即可创建标题,如下代码:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

引语

>符号加空格跟随内容可添加引语,如下代码:

> 这是引语
> 您可添加自己的内容

效果:

这是引语 您可添加自己的内容

加粗

**包起来的文本可以显示文本的加粗效果,如下代码:

**这是加粗文本的示例**

效果: 这是加粗文本的示例

斜体

*单个星号包括起来的文本可以显示斜体,如下代码:

*这个是文本的斜体显示的示例*

效果: 这个是文本的斜体显示的示例

下划线

++两个加号包起来的文本内容会显示下划线,如下代码:

++这是文本显示下划线的例子++

效果: 这是文本显示下划线的例子

中划线、删除线

~~两个波浪线包起来的文本可以显示中划线,也叫删除线,如下代码:

~~这是文本显示中划线的例子~~

效果: 这是文本显示中划线的例子

高亮

‘==’两个连续的等号前后包起来的文本可显示高亮效果,如下代码:

==这是高亮显示文本的例子==

效果: ==这是高亮显示文本的例子==

-单个短横线加空格可在文本开头显示句点,如下代码:

- 这是句点的例子
	- 这是子句点
		- 例子

效果:

  • 这是句点的例子
    • 这是子句点
      • 例子

--两个短横线可以在文本前添加短横线,如下代码:

--这是短横线的例子

效果: --这是短横线的例子

分割线

---三个以上的短横线可添加华丽的分割线,如下代码:

---
------

效果:



目录标签

[toc]关键字可添加目录索引(有的编辑器有),如下代码:

# 目录示例
[toc]
## 分类目录1
### 子目录
#### 孙子目录

效果(图):
typoraexample 注: 关于目录还可用标签定义索引,然后使用[名称](索引)的方式来实现,如下代码:

[跳转本文ID等于99的位置](#99)

------
###### <span id='99'>ID99的索引</span>


效果: 跳转本文ID等于99的位置


ID99的索引

代码

代码块

’符号可在文本段中添加代码(位于键盘上波浪线~`键下方),通常成对出现,如下代码:

`这是代码块的示例`
这是`代码块`的示例

效果: 这是代码块的示例 这是代码块的示例

代码段

‘```’三个连续的反引号可创建代码段,通常我们还会在开头指定编程语言来显示代码高亮的特性,如下代码:

	```python
	#python脚本
	#!/usr/bin/python3
	import sys
	
	list = [ 1,2,3,4,5 ]
	print("hello world!")
	```
	```nginx
	#nginx配置文件
	server {
		listen 80;
		........
	}
	```
	```c++
	//C++例子
	#include <iostream>
	using namespace std;
	int main(){
		cout<<"hello world!"<<endl;
		return 0;
	} 
	```

显示效果:

#!/usr/bin/python3
#python脚本
import sys

list = [ 1,2,3,4,5 ]
print("hello world!")
#nginx配置文件
server {
	listen 80;
	........
}
//C++例子
#include <iostream>
using namespace std;
int main(){
	cout<<"hello world!"<<endl;
	return 0;
} 

有序列表

阿拉伯数字跟随英语句点和空格可在句子前显示序号,在富文本编辑器中,通常会自动递增数字的值,如下代码:

1. 这是第一步
2. 这是第二步
	1. 这是嵌套
	2. 其他

效果:

  1. 这是第一步
  2. 这是第二步
    1. 这是嵌套
    2. 其他

插入超链接

使用"[描述](URL)"组合可插入链接,如下代码:

[百度一下,你就知道](https://www.baidu.com)

效果: 百度一下,你就知道

插入图片

使用“![描述](URL)”组合可插入图片链接,如下代码:

#引号内可添加文本,鼠标悬停时会有文本注释
![IMG_2166i386small2](https://oss.zhuyongci.com/bookimg/IMG_2166i386small2.png!style "Yong's Blog")

效果:

IMG_2166i386small2

注: 图片也支持本地图片,走file://协议即可,但这种文档不能在网络上发布。一般我们是用对象存储或图床存放图片。

插入表格

插入表格通常推荐使用富文本编辑器,因为手动加太膈应人了,如下是一个3*4的表格:

|column1|column2|column3|column4|
| ----- | ----- | ----- | ----- |
|content1|content2|content3|content4|
|content1|content2|content3|content4|
#下面是一些对齐的写法
#| :--: |	文字居中对齐
#| :--- |	文字左对齐
#| ---: |	文字右对齐

效果:

column1column2column3column4
content1content2content3content4
content1content2content3content4

注: 本站此主题可能无法看出对齐效果,在某些富文本编辑器内是可以看到效果的。

插入数学表达式

使用"$"符号将表达式包住,即可显示数学表达式的效果,如下代码:

#并不是所有平台或主题元素都支持该语法
#比如说本站目前的这套主题模板就不支持LaTex
$x+y=z$

$ax^2+bx+c=0$

x^2^+y^3^/z^10^=s

效果: LaTex_explate20190831235839

插入HTML代码

由于Markdown的底层是由HTML语法来实现的,所以,在日常编写中,您可在任意位置加入HTML标签,以此来实现更个性化的显示,如下代码:

#### 这是`Markdown`标题
<a href="https://www.zhuyongci.com" target="_blank">这是超链接</a><br/>
**图片HTML标签**
<img src="https://oss.zhuyongci.com/bookimg/IMG_2166i386small2.png!style" alt="IMG_2166i386small2"/><br/>
**HTML DIV标签**
<div>
	<font size="5" color="#FF6600">颜色文字示例</font>
	<br/>
</div>
<div>
调整图片和文字一行,图片居中与文字对齐
<img src="https://oss.zhuyongci.com/bookimg/IMG_2166i386small2.png!style" style="vertical-align:middle" width="50" alt="IMG_2166i386small2"/>
</div>

效果:

这是Markdown标题

这是超链接
图片HTML标签 IMG_2166i386small2
HTML DIV标签

颜色文字示例
调整图片和文字一行,图片居中与文字对齐 IMG_2166i386small2

这里仅列出部分常用语法,利用这些已经能写出比较工整的文章了;更多用法请自行百度。

PS:typora中可利用快捷键添加各种样式,但我更推荐养成用Markdown标准语法来写的方式,因为这样,不受限于编辑器,即便是用记事本也能写出一篇完美的文档。

评论

Your browser is out-of-date!

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

×