Markdown语法

markdown图标

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/

附上有title显示的效果图

效果说明

链接格式:
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列表 (无序,有序)
无序
通过"." 、"+"、"*"、或"-" 标记'无序列表',如:
-  第一个
-  第二个
+  第二个
*  第三个
*  第四个

效果如下:

  • 第一个
  • 第二个
  • 第二个
  • 第三个
  • 第四个
    无序列表.png

效果说明

无序列表中"." 、"+"、"*"、或"-" 标记都可以用,嵌套用的话会隔很大的空间
注意:标记和文字之间至少有一个空格,简书似乎不支持"."符号,所以这里没有
演示,我用其他的工具是可以的
有序
1. 第一个
1. 第一个
1. 第一个
1. 第一个  


1. 第一个
 第一个的内容
1. 第二个
+ 无序表格
4. 第三个
2. 第四个
0. 第五个

效果如下:

  1. 第一个
  2. 第一个
  3. 第一个
  4. 第一个
  1. 第一个
    第一个的内容
  2. 第二个
  • 无序表格
  1. 第三个
  2. 第四个
  3. 第五个

效果说明

有序列表通过数字加"."进行自动的标号,生成后的序号从1开始,可以插入无序列表
注意:"."后面至少一个空格
2.7分割线
***
---
_____ 

效果如下:




3.图片

添加图片形式和链接类似,只需要在链接的格式上最前方加一个"!"即可
![Markdown](https://upload-images.jianshu.io/upload_images/7473008-4962c96ed733892d.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

效果如下:

Markdown

效果说明

     ![Message](URL)                  不带title的
     ![Message](URL "title")          带title的,URL与"title"之间至少一个空格

4.反斜杠"\"

如果您使用"*"不是为了让它具有一个特殊功能,比如标记无序列表或是斜体粗体
等,而是想让它直接输出为一个星号字符就可以这样: 
\*\*it\*\*
**it**
\+ 1
* 1
\* 1

效果如下:
**it**
it
+ 1

  • 1
    * 1

效果说明

想让特殊功能字符原样输出就可以用反斜杠"\"转义("\"也称为转义符)

5.表格

姓名|性别
-|-
瓜瓜|男
冒冒|女

姓名|城市
-:|-:
瓜瓜|江西
冒冒|江西

效果如下:

姓名 性别
瓜瓜
冒冒
姓名 城市
瓜瓜 江西
冒冒 江西

效果说明

表格单元内容默认是左对齐的,可以通过"-|-"加冒号改变,比如:
"-:|-:"        两列都是右对齐
"-|-:"         第一个列左对齐,第二个列是右对齐
"-|:-:"        第一个列左对齐,第二个列是居中

详细语法请参考
Markdown 语法说明

感谢您的阅读,如有写的不妥之处,还望您批评指正,谢谢

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。