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 语法说明

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,684评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,143评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,214评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,788评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,796评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,665评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,027评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,679评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,346评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,664评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,766评论 1 331
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,412评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,015评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,974评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,073评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,501评论 2 343