Markdown是什么?
一种轻量级标记语言,主要用于文档写作
标记语言还有HTML,XML等
Markdown的优点
Markdown的语法简洁明了、容易上手,而且功能比纯文本更
强。很多博客平台均支持Markdown,github的README.MD等类似
的说明文档也均采用Markdown编写
Markdown的使用指南
1.标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果如下:
效果说明
标题一共分为六级,"#"号的个数代表级数,标题文字与"#"至少一个空格(space或是tab都可以)
具体格式为:# 空格 标题文字
2.文本样式
2.1链接
这是一个[简书链接](https://www.jianshu.com/)
这是一个简书链接(https://www.jianshu.com/)
这是一个[简书链接](https://www.jianshu.com/ "title我是简书哦")
https://www.jpjbp.com/
(https://www.jpjbp.com/)
<https://www.jianshu.com/>
效果如下:
这是一个简书链接
这是一个简书链接(https://www.jianshu.com/)
这是一个简书链接
https://www.jianshu.com/
(https://www.jpjbp.com/)
https://www.jianshu.com/
效果说明
链接格式:
URL 自生成链接
<URL> 自生成链接
(URL) 前面没有中括号会生成一个带括号的链接
[文字](URL) 不带标题,符号"]"和"("之间不能有其他字符,空格都不行
[文字](URL空格"标题内容") 带标题,记得URL和标题内容之间加空格
2.2强调
~~删除~~
**加粗**
__加粗__
*斜体*
_斜体_
*__斜体加粗__*
__*斜体加粗*__
_**斜体加粗**_
**_斜体加粗_**
效果如下:
删除
加粗
加粗
斜体
斜体
斜体加粗
斜体加粗
斜体加粗
斜体加粗
斜体加粗
斜体加粗
效果说明
下划线"_"和星号"*"效果基本相同
特别说明:带"*"星号的文本样式,在原版Markdown标准中不存在,但在其大部分衍生标准中被添加
2.3段落
一个'Markdown段落'是由一个或多个连续的文本行组成,它的前后要有一个以上
的空行。普通段落不该用空格或制表符来缩进。段落的前后要有'空行'。(所谓的空
行是指没有文字内容,通过Enter键即可。若想在段内强制换行的方式是使用两个
以上空格加上回车)
效果展示:
我是一个段落,就像word中的正文
2.4区块引用
在需引用的行使用符号 ">" ,也可使用多个嵌套引用,如:
>一切都是命运石门的选择
>一级引用嵌套
>>二级引用嵌套
>>>>四级引用嵌套
一切都是命运石门的选择
一级引用嵌套
二级引用嵌套
四级引用嵌套
2.5代码区块
代码区块的建立是在每行加上4个空格或者二个制表符(如同写代码一样)。
不同的编写工具在空格和制表符的数量上会有差异,简书Markdown是符合的
可以用下面的写法代码块的开头和结尾均用三个"`"符号。(注意:"`"不是单引号,
是Tab键上面的那个,称为反引号(backquote))
行内短代码`System.out.println("我是瓜瓜")`
```
public static void main(String[] args){
Scanner scanner = new Scanner(System.in);//创建一个Scanner的实例
String s = scanner.nextLine();
System.out.println("您输入的是:"+s)
}
```
```
<school>
<teacher>瓜瓜</teacher>
<student>冒冒</student>
</school>
```
```
<html>
<head>
<title>这是标题</title>
</head>
<body>我是身体</body>
</html>
```
效果如下:
行内短代码System.out.println("我是瓜瓜")
public static void main(String[] args){
Scanner scanner = new Scanner(System.in);//创建一个Scanner的实例
String s = scanner.nextLine();
System.out.println("您输入的是:"+s)
}
<!--我是一个注释-->
<school>
<teacher>我</teacher>
<student>你</student>
</school>
<html>
<head>
<title>这是标题</title>
</head>
<body>我是身体</body>
</html>
2.6列表 (无序,有序)
无序
通过"." 、"+"、"*"、或"-" 标记'无序列表',如:
- 第一个
- 第二个
+ 第二个
* 第三个
* 第四个
效果如下:
- 第一个
- 第二个
- 第二个
- 第三个
- 第四个
效果说明
无序列表中"." 、"+"、"*"、或"-" 标记都可以用,嵌套用的话会隔很大的空间
注意:标记和文字之间至少有一个空格,简书似乎不支持"."符号,所以这里没有
演示,我用其他的工具是可以的
有序
1. 第一个
1. 第一个
1. 第一个
1. 第一个
1. 第一个
第一个的内容
1. 第二个
+ 无序表格
4. 第三个
2. 第四个
0. 第五个
效果如下:
- 第一个
- 第一个
- 第一个
- 第一个
- 第一个
第一个的内容 - 第二个
- 无序表格
- 第三个
- 第四个
- 第五个
效果说明
有序列表通过数字加"."进行自动的标号,生成后的序号从1开始,可以插入无序列表
注意:"."后面至少一个空格
2.7分割线
***
---
_____
效果如下:
3.图片
添加图片形式和链接类似,只需要在链接的格式上最前方加一个"!"即可
![Markdown](https://upload-images.jianshu.io/upload_images/7473008-4962c96ed733892d.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
效果如下:
效果说明
![Message](URL) 不带title的
![Message](URL "title") 带title的,URL与"title"之间至少一个空格
4.反斜杠"\"
如果您使用"*"不是为了让它具有一个特殊功能,比如标记无序列表或是斜体粗体
等,而是想让它直接输出为一个星号字符就可以这样:
\*\*it\*\*
**it**
\+ 1
* 1
\* 1
效果如下:
**it**
it
+ 1
- 1
* 1
效果说明
想让特殊功能字符原样输出就可以用反斜杠"\"转义("\"也称为转义符)
5.表格
姓名|性别
-|-
瓜瓜|男
冒冒|女
姓名|城市
-:|-:
瓜瓜|江西
冒冒|江西
效果如下:
姓名 | 性别 |
---|---|
瓜瓜 | 男 |
冒冒 | 女 |
姓名 | 城市 |
---|---|
瓜瓜 | 江西 |
冒冒 | 江西 |
效果说明
表格单元内容默认是左对齐的,可以通过"-|-"加冒号改变,比如:
"-:|-:" 两列都是右对齐
"-|-:" 第一个列左对齐,第二个列是右对齐
"-|:-:" 第一个列左对齐,第二个列是居中
详细语法请参考
Markdown 语法说明
感谢您的阅读,如有写的不妥之处,还望您批评指正,谢谢