- 这篇主要介绍一些常用的Markdown语法,请耐心阅读,估计很快就可以看完
- 边阅读边操作,可以获得即时反馈,学习效率会更高。你可以下载Typora编辑器或者打开CSDN,登陆后点击写博客,可以立刻实战,左边是Markdown语法,后边可以直接看到显示结果,还是很棒的
段落、换行:如何换行
标题:创建一级标题、二级标题之类的,为了让文章有主次之分,表示各部分之间的关系
引用:创建引用文字
列表:创建有序列表,就是123这样的,或者无序列表
代码:输入代码和代码高亮
分割线:创建分割线
链接:链接到其他文件,其他标题,或者其他网址
相对路径:学会链接的必要知识
符号指示:像这样,就这样
段落,通常指的是一行或者多行连续的文本。
默认情况下,段落之间是以多个空行进行分隔的。我们只需要按下回车键
就可以完成段落分隔。
有些编辑器中,会忽略掉换行。进行换行操作的时候,可以使用Shift
+ 回车
。
创建标题,可以在文本行的开头输入1-6个井号,#
。不同个数的#
,代表着标题的等级。就像在Word中,一个井号,#
,代表着一级标题。两个井号,##
,代表着二级标题。
注意,#
后面,要空一格再输入标题
标题的显示效果以及无空格的错误示范:
所以大家记得要加空格
引用,近些年在文章中使用的越来越多了。下面的显示效果,你一定不陌生。
这是一段引用文字。
你只需要在文字前面输入>
就可以(最后在>
后加空格,虽然有些编辑器会帮你补全这个空格)
> 这是一段引用文字。
注意,如果回车后不想继续使用这个符号所代表的功能,再一次按下回车,如下
第一段引用
(回车后会这样,但是不想引用了,可以继续按下回车,这一行文字的引用就会消失)
列表的话,分为有序列表,和无序列表。
你可以使用*
或者+
,-
来创建无序列表。
* 这是无序列表1
+ 这是无序列表2
显示效果:
-
这是无序列表1
-
这是无序列表2
可以使用1.
来创建有序列表,注意别少了那一点
1. 这是有序列表1
2. 这是有序列表2
显示效果:
- 这是有序列表1
- 这是有序列表2
Github显示代码块的符号与原始Markdown的有所不同。
但Github的这种方式在很多编辑器中都使用,因为相对原来的表示方式,这种表示方式比较简单
在Github中,你只需要输入``` ,然后按下 回车
。除此之外,我们可以在```后面加上代码使用的语言,就会有代码高亮。
def highlight():
print('Ok, give you the highlighting')
这一段代码可以这样写:
```python
def highlight():
print('Ok, give you the highlighting')
```
`这个符号,在键盘的这个位置:
在英文状态下,输入即可。
在原始的Markdown中,使用<pre><code>
和</code></pre>
来表示代码块。在绝大多数的编辑器中都是支持的,但是使用过程相对比较麻烦。
<pre><code>
This is a code block.
</code></pre>
在知乎的回答中,经常会有分割线的出现(像这样):
创建分割线,只需要输入---
或者***
,然后按下回车
就行了
链接可以指:
这些链接都有着统一的格式:
[需要创建链接的文字](链接地址)
链接文字是没有限制的,所以上面四种链接的不同,在于链接地址的不同。
如果指向一个网址,直接在小括号中直接输入网址就可以了
比如第一个,指向一个网址,github
[github](www.github.com)
后面的三种,需要使用到路径,一般是分为绝对路径和相对路径的。
相对路径,对于文件迁移来说更加友好
相对路径,需要找一个参照物,来进行相对比较。这个参照物就是当前文件。
比如,我们这个文件叫SpanElement.md
这就相当于起点,接下来我们要根据指令形式。
如果我让你找README,你可以直接找到。(链接的文件与当前文件在同一个目录下,可以直接输入名称进行链接)。当然,我们也可以使用./
,这个表示当前目录。
比如第二个,可以指向另一个文件,比如:快速开始指南
[快速开始指南](QuickStart.md)或者[快速开始指南](./QuickStart.md)
比如,我们想获取imgs
文件夹中的pig01.png
,/
表示下一级目录。
现在我们站在这里,给我们一个pig01.png
,我们拿着这个指令,四处张望,没有发现目标。
如果先告诉我们./imgs
或imgs
,我们是可以找到imgs
文件夹的。
然后我们站在imgs
文件夹面前,发现如果想进去的话,还必须要一把钥匙,这个钥匙就是/
。当我们进入imgs
文件夹中,就可以找到pig01.png
文件了。
所以可以表示为:
./imgs/pig01.png或imgs/pig01.png
比如我们想链接上一个小标题,链接其他目录文件
,只要用在小括号中,在#
后输入标题的名称就可以了
[链接到其他目录](#链接其他目录名称)
显示效果:
只需要先链接到某一文件,然后加上#
标题就行了。就是进行一个组合,但这种方式,在其他编译器中,不一定有用
比如我们想链接README.md
文件中的如何使用
。
[如何使用](./README.md#如何使用)或[如何使用](README.md#如何使用)
显示效果:
插入图片,是建立在链接的基础上的。
在链接的语法基础前,加上!
进行区分即可。
![自定义图片名字](图片地址)
![wechat](imgs/wechat.jpg)
显示效果:
在文字的两端输入**
或__
,可以使文字变成斜体
**我要粗了**(推荐,不用切换中英文,适用面更广)
__看我粗了__
显示效果:
我要粗了 看我粗了
当我们需要强调一个符号或者一个函数的时候,可以在符号或者函数的两端使用`。
`看我不一样了`
显示效果:
看我不一样了