Markdown语法

Markdown语法介绍

Markdown 是一种方便记忆、书写的纯文本标记语言,用户可以使用这些标记符号以最小的输入代价生成极富表现力的文档:譬如您正在阅读的这份文档。它使用简单的符号标记不同的标题,分割不同的段落,粗体 或者 斜体 某些文字

用途

Markdown的语法简洁明了、学习容易,而且功能比纯文本更强,因此有很多人用它写博客。世界上最流行的博客平台WordPress和大型CMS如JoomlaDrupal都能很好的支持Markdown。


Markdown语法运用

1.标题:

标题能显示出文章的结构。行首插入1-6个 # ,每增加一个 # 表示更深入层次的内容,对应到标题的深度由 h1-h6 阶写法(依次对应HTML的h1-h6标签):

h1 : # 一级标题
h2 : ## 二级标题
h3 : ### 三级标题
h4 : #### 四级标题
h5 : ##### 五级标题
h6 : ###### 六级标题

效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

首行插入1-6个#号,代表更深入层次的内容有时候为了美观,也可以这样进行输入。

h1 = # 一级标题 #

注:#号和标题之间要+空格

2.分级标题

写法:

一级标题
=======
二级标题
---------
注:=、-可以只写一个

效果:

效果

3.文本样式

写法:

链接 :[Title](URL)
加粗 :**Bold**
斜体字 :*Italics*
删除线 :~~text~~
高亮 :==text==
段落 : 段落之间空一行
换行符 : 一行结束时输入两个空格
列表 :* 添加星号成为一个新的列表项。
引用 :> 引用内容
内嵌代码 : 'alert('Hello World');'
画水平线 (HR) :--------

效果:

链接 :Title
加粗 :Bold
斜体字 :Italics
删除线 :text

高亮 :==text==
段落 : 段落之间空一行
换行符 : 一行结束时输入两个空格
列表 :* 添加星号成为一个新的列表项。
引用 :> 引用内容
内嵌代码 : 'alert('Hello World');'
画水平线 (HR) :--------

4.超链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式,行内式一般使用较多。

4.1.行内式

写法:

欢迎来使用[谷歌搜索](https://www.google.com/)
效果:
欢迎来使用谷歌搜索

4.2.参考式

参考式超链接一般用在学术论文上面,或者另一种情况,如果某一个链接在文章中多处使用,那么使用引用 的方式创建链接将非常好,它可以让你对链接进行统一的管理。
写法:

我经常去几个网站谷歌百度以及自己的简书
文字和链接中间要空一行

```[1]:https://www.google.com/ "google"```
```[2]:https://www.baidu.com/   "baidu"```
```[3]://www.greatytc.com/ "fanmucc"```

效果:

我经常去几个网站谷歌百度以及自己的简书

4.3.自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用<>包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:

写法:

<https://www.google.com/>
<https://www.baidu.com/>

效果:

https://www.google.com/
https://www.baidu.com/

5.表格

注意: 代表对齐方式 ,** : 与 | 之间不要有空格**,否则对齐会有些不兼容,同样表格与上一行内容需要用回车保持一行的间隔,不然在运行后会出现双表格(两个一摸一样的表格)。
写法以及效果:

| 年级 | 姓名 | 性别 |
|:----:|:----|----:|
|一年级 |张三| 男|
|============|=======|========|

年级 姓名 性别
一年级 张三
=========== ========== ===========

效果:

年级 姓名 性别
一年级 张三
=========== ========== ===========

注:||之间没有空格限制,不需要刻意对其。

6.列表

6.1 无序列表

无序列表使用星号、加号和减号来做为列表的项目标记,这些符号是都可以使用的,使用星号。
写法:

星号:
* 字体1
* 字体2
* 字体3
加号:
+ 字体4
+ 字体5

+ 字体6

减号:
- 字体7
- 字体8
- 字体9

效果:

星号:

  • 字体1
  • 字体2
  • 字体3

加号:

  • 字体4
  • 字体5
  • 字体6

减号:

  • 字体7
  • 字体8
  • 字体9

6.2 有序列表

有序的列表则是使用一般的数字接着一个英文句点作为项目标记。
写法:

1.张三
2.张四
3.张五

效果:

1.张三
2.张四
3.张五

7.图片

引入图片有两种方式,分别是行内式和参考式。参考式有利于链接的管理

7.1 行内式

写法:

![图片Alt](图片链接)
![示例](https://i.loli.net/2018/04/17/5ad5ada434e90.png)

效果:

示例

7.2 参考式

写法:

![示例][photo]
两者之间需要空一行
[photo]:图片链接
![示例][photo]
两者之间需要空一行
[photo]:![示例](http://upload-images.jianshu.io/upload_images/11461186-389f3294c0d04b98.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

效果:

示例
示例

8.代码

一种是利用缩进(Tab), 另一种是利用”`”符号(一般在ESC键下方)包裹代码。

8.1 行内式代码

写法:

前端怎么使用`<div>`标签;

效果:

前端怎么使用<div>标签

8.2 缩进多行代码

缩进 4 个空格或是 1 个制表符
一个代码区块会一直持续到没有缩进的那一行(或是文件结尾
写法:

   <html>
      <head>
        <title>
        </title>
      </head>
    <body>
    </body>
   </html>

效果:

   <html>
      <head>
        <title>
        </title>
      </head>
    <body>
    </body>
   </html>

8.3.代码标记块

写法:

```
<body>
<p>你好</p>
</body>
```

效果:

<body>
<p>你好</p>
</body>

9.分割线

在markdown语法中,一行连用三个或者三个以上的星号,减号,或者下划线,就可以表示分割线.
例如:***; ---;___

效果:
***


---

___


本文章会长期进行更新


注:关于用Markdown语法上传到Github上乱码问题

本人测试将在本地仓库写的.md文件上传到github上出现乱码,并且将字符编码保存为utf-8,同样也出现问题。


github项目截图

3个.md文件,只有第一个README.md文件没有形成乱码,后来查找发现自己其中两个文件命名错误,导致上传后出现乱码。
github上的.md文件一定要命名为README.md,希望大家在以后不要像我一样粗心大意。

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

推荐阅读更多精彩内容