markdown基本用法以及表现方式

说明

这是一种适用于网络的书写语言,在我们写自己的博客或者发表我们一些自己的文章非常实用,它能够让文章更容易读,更容易写,以及可以随意更改。这是一种书写的格式。

兼容HTML

还有一个重要的点,这种语法兼容HTML,markdown的基本语法可能只会有一些常用的标签,但是如果你想使用更多额外的标签,那么你可以直接加入你希望加入的标签即可,不需要特殊注明。

可能有一些制约区块元素–比如<div>、<table>、<pre>、<p>等,必须前后都有空行与其它标签分开,并且它们的开始标签和结束标签不能用制表符或者空格来缩进。

下面这个例子就是在markdown的文件里面加上一段HTML表格:

1
2
3
4
5
6
7
这是一个普通的段落
<table>
<tr>
<td>表格项<td>
</tr>
</table>
这是结尾的段落

如果你喜欢HTML的<a>或者<img>标签,那么你在你的文章里面可以直接使用,而不用markdown给你提供的链接或者图片的标签语法,当然这个看个人爱好。

段落和换行

一个段落是由一个或者多个连续的文本组成,前后存在空行即可产生段落。

当然使用<br />标签也可以进行换行

在需要换行的地方要按两个以上的空格然后回车也可以产生换行效果。

标题

语法:

1
2
3
4
5
6
# 这是H1
## 这是H2
### 这是H3
#### 这是H4
##### 这是H5
###### 这是H6

根据标题层次来形成文章的结构,自动生成标题栏

区块引用

在每一行前面加上>即表示区块引用

也允许你偷懒只在整个段落的第一行最前面加上>即可

区块引用可以嵌套,根据层次加上不同数量的>,区块引用内也可以使用其它的markdown语法

1
2
> 1. 这里是区块引用
> > 1.1 这里是例子
  1. 这里是区块引用

    1.1 这里是例子

列表

有序列表

1
2
3
1. green
2. red
3. blue
  1. green
  2. red
  3. blue

无序列表

无序列表使用星号、加号或者减号作为标记

1
2
3
4
5
6
7
8
9
10
11
* green
* red
* blue
或者
+ green
+ red
+ blue
再或者
— green
- red
- blue
  • green
  • red
  • blue

列表嵌套

如果要在列表中放进引用,那么符号>就需要缩进

如果要放入代码块,则需要缩进两次

1
2
3
4
* 水果
> 苹果
> 橘子
<strong>粗体</strong>
  • 水果

    苹果
    橘子
    粗体

表格

在markdown中使用表格,默认情况一般是表格内容默认左对齐,表头单元格中的内容居中对齐,不同的实现可能会有不同的表现形式,具体的在markdown中是如何使用呢?

1
2
3
4
| 一个普通标题 | 一个普通标题 | 一个普通标题 |
| ------ | ------ | ------ |
| 短文本 | 中等文本 | 稍微长一点的文本 |
| 稍微长一点的文本 | 短文本 | 中等文本 |

效果如下:

一个普通标题 一个普通标题 一个普通标题
短文本 中等文本 稍微长一点的文本
稍微长一点的文本 短文本 中等文本

那么表格中的内容如果有不同的对齐方式如何实现呢

1
2
3
4
| 左对齐标题 | 右对齐标题 | 居中对齐标题 |
| :------| ------: | :------: |
| 短文本 | 中等文本 | 稍微长一点的文本 |
| 稍微长一点的文本 | 短文本 | 中等文本 |

效果如下:

左对齐标题 右对齐标题 居中对齐标题
短文本 中等文本 稍微长一点的文本
稍微长一点的文本 短文本 中等文本

代码区块

在markdown中,建立代码区块很简单,只需要简单的进行四个空格或者一个制表符即可。

在代码区块中,一般的markdown语法不会被转换,星号就是星号,所以你可以很随意的使用代码区块来书写你想要的代码内容。

1
2
3
<div class="footer">
&copy; 2004 Foo Corporation
</div>

分割线

你可以在一行中使用三个以上的星号,减号,底线来建立分割线,行内不允许存在其它东西。例如:

1
2
3
4
5
*******
* * * *
***
- - -
-----------------





链接

行内式链接

建立一个行内式链接,具体的形式如下:

这是一个有title的[链接](https://renyanan.com "臭臭💩首页")
可以点击[链接](https://renyanan.com)跳转

这是一个有title的链接,可以点击链接跳转

格式说明:[]方括号内是链接文字,()内是链接地址,如果你想要在链接上加上链接的title文字,那么你可以在小括号的链接后面加上一个空格,然后在写上title的内容,用双引号包起来即可,如同上面的实例的第一个链接。

如果你想要链接的是同一主机的资源,则可以使用相对路径

[相对路径链接](/2019/01/17/markdown基本用法以及表现方式/index/ "臭臭💩首页")

相对路径链接

参考式链接

参考式链接是指在链接文字的后面再跟上一个方括号,而在第二个方括号中要填入辨识的标记

写法如下:

1
2
3
这里是一个[参考式链接][baidu],链接到百度。

[baidu]: https://baidu.com "title"

这里是一个参考式链接,链接到百度。

说明:

  • 方括号里面输入链接文字
  • 接着一个冒号
  • 接着一个空格
  • 接着链接的网址
  • 选择性地接着 title 内容,可以用单引号、双引号或是括弧包着

这两种方式都能够达到预期的效果,但是参考式链接可以明显的看出它比较好读,比较一下上面的两种方式,当在一个文章中出现大量的链接的时候,参考式链接可以将一些标记相关的元数据移到文章之外,不影响文章的正常阅读。

强调

markdown使用星号以及底线作为标记强调字符的符号,被*或者_包围的字词会被转成斜体字,当然使用**或者__包围的字符则会被加粗显示。

1
2
3
4
*斜体*
_斜体_
**加粗**
__加粗__

斜体
斜体
加粗
加粗

如果你的文字前后想要插入普通的星号或者底线,可以用反斜线。

\*测试段落前后追加普通的强调符号\*

*测试段落前后追加普通的强调符号*

代码

如果你想要标记一小段行内代码,你可以使用反引号把它包起来(`),例如

这是行内`alert('你好')`代码

如果你的代码区段包含反引号,那么你可以使用多个反引号来开启和结束你的代码区块

这是行内``alert('你好`')``代码

图片

行内式图片

行内式图片语法

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

详细叙述如下:

  • 一个惊叹号!
  • 接着一个方括号,里面放上图片的替代文字
  • 然后一个普通括号,里面放上图片的网址,最后还可以用引号包住并选择性的加上title的文字

动漫图片

参考式图片

语法

![Alt text][id]
id是图片参考的名称
[id]: url/to/image  "描述文字"

到目前为止,markdown还没有办法来指定图片的宽高,如果你想要指定图片的宽高,那么你可以使用普通的<img>标签

其它

特殊字符

markdown可以使用反斜杠来插入一些有其他意义的符号,下面这些符号前面加上反斜杠即可正确插入这些普通的符号

\  反斜线
`  反引号
*  星号
_  底线
{} 花括号
[] 方括号
() 括号
#  井号
+  加号
-  减号
.  英文句点
!  英文叹号

自动链接

<https://baidu.com>

markdown会显示为:

https://baidu.com

当然你也可以这么写你的邮箱

<978127576@qq.com>

978127576@qq.com

如果有什么问题,欢迎大家留言,还有什么没有提及到的,也欢迎大家补充!

小伙子别走,如果帮到您你懂得☺
0%