Skip to content

Latest commit

 

History

History
295 lines (172 loc) · 7.9 KB

QuickStart.md

File metadata and controls

295 lines (172 loc) · 7.9 KB

快速开始

前言与准备

  • 这篇主要介绍一些常用的Markdown语法,请耐心阅读,估计很快就可以看完
  • 边阅读边操作,可以获得即时反馈,学习效率会更高。你可以下载Typora编辑器或者打开CSDN,登陆后点击写博客,可以立刻实战,左边是Markdown语法,后边可以直接看到显示结果,还是很棒的

目录

段落、换行:如何换行

标题:创建一级标题、二级标题之类的,为了让文章有主次之分,表示各部分之间的关系

引用:创建引用文字

列表:创建有序列表,就是123这样的,或者无序列表

代码:输入代码和代码高亮

分割线:创建分割线

链接:链接到其他文件,其他标题,或者其他网址

链接网址

相对路径:学会链接的必要知识

链接当前目录文件

链接其他目录文件

链接某一个标题

链接到某一个文件的某一个标题

插入图片

加强(加粗)

符号指示:像这样,就这样

开始

段落和换行符

段落,通常指的是一行或者多行连续的文本。

默认情况下,段落之间是以多个空行进行分隔的。我们只需要按下回车键 就可以完成段落分隔。

para02

这是段落分隔

有些编辑器中,会忽略掉换行。进行换行操作的时候,可以使用Shift + 回车

para01

这是换行

标题

创建标题,可以在文本行的开头输入1-6个井号,#。不同个数的#,代表着标题的等级。就像在Word中,一个井号,#,代表着一级标题。两个井号,##,代表着二级标题。

注意,#后面,要空一格再输入标题

标题的显示效果以及无空格的错误示范

tit01

所以大家记得要加空格

引用

引用,近些年在文章中使用的越来越多了。下面的显示效果,你一定不陌生。

这是一段引用文字。

你只需要在文字前面输入>就可以(最后在>后加空格,虽然有些编辑器会帮你补全这个空格)

> 这是一段引用文字。

注意,如果回车后不想继续使用这个符号所代表的功能,再一次按下回车,如下

第一段引用

(回车后会这样,但是不想引用了,可以继续按下回车,这一行文字的引用就会消失)

列表

列表的话,分为有序列表,和无序列表。

你可以使用*或者+,-来创建无序列表。

* 这是无序列表1
+ 这是无序列表2

显示效果:

  • 这是无序列表1

  • 这是无序列表2

可以使用1.来创建有序列表,注意别少了那一点

1. 这是有序列表1
2. 这是有序列表2

显示效果:

  1. 这是有序列表1
  2. 这是有序列表2

代码块

Github显示代码块的符号与原始Markdown的有所不同。

但Github的这种方式在很多编辑器中都使用,因为相对原来的表示方式,这种表示方式比较简单

在Github中,你只需要输入``` ,然后按下 回车。除此之外,我们可以在```后面加上代码使用的语言,就会有代码高亮。

def highlight():
    print('Ok, give you the highlighting')

这一段代码可以这样写:

```python
def highlight():
    print('Ok, give you the highlighting')
```

`这个符号,在键盘的这个位置:

code

在英文状态下,输入即可。

在原始的Markdown中,使用<pre><code></code></pre>来表示代码块。在绝大多数的编辑器中都是支持的,但是使用过程相对比较麻烦。

<pre><code>
This is a code block.
</code></pre>

水平线(分割线)

在知乎的回答中,经常会有分割线的出现(像这样):


创建分割线,只需要输入---或者***,然后按下回车就行了

链接

链接可以指:

  • 指向一个网址,比如:github
  • 可以指向另一个文件,比如:快速开始指南
  • 可以指向这个文件的某一个标题,比如:插入图片
  • 甚至可以指向另一个文件的某一个标题,比如指向README文件中的如何使用

这些链接都有着统一的格式:

[需要创建链接的文字](链接地址)

链接文字是没有限制的,所以上面四种链接的不同,在于链接地址的不同。

链接网址

如果指向一个网址,直接在小括号中直接输入网址就可以了

比如第一个,指向一个网址,github

[github](www.github.com)

后面的三种,需要使用到路径,一般是分为绝对路径和相对路径的。

相对路径,对于文件迁移来说更加友好

相对路径

相对路径,需要找一个参照物,来进行相对比较。这个参照物就是当前文件。

比如,我们这个文件叫SpanElement.md

relative

这就相当于起点,接下来我们要根据指令形式。

链接当前目录文件

如果我让你找README,你可以直接找到。(链接的文件与当前文件在同一个目录下,可以直接输入名称进行链接)。当然,我们也可以使用./,这个表示当前目录。

比如第二个,可以指向另一个文件,比如:快速开始指南

[快速开始指南](QuickStart.md)或者[快速开始指南](./QuickStart.md)
链接其他目录文件

比如,我们想获取imgs文件夹中的pig01.png/表示下一级目录。

现在我们站在这里,给我们一个pig01.png,我们拿着这个指令,四处张望,没有发现目标。

如果先告诉我们./imgsimgs,我们是可以找到imgs文件夹的。

然后我们站在imgs文件夹面前,发现如果想进去的话,还必须要一把钥匙,这个钥匙就是/。当我们进入imgs文件夹中,就可以找到pig01.png文件了。

所以可以表示为:

./imgs/pig01.png或imgs/pig01.png

链接某一个标题

比如我们想链接上一个小标题,链接其他目录文件,只要用在小括号中,在#后输入标题的名称就可以了

[链接到其他目录](#链接其他目录名称)

显示效果:

链接到其他目录

链接到某一个文件的某一个标题

只需要先链接到某一文件,然后加上#标题就行了。就是进行一个组合,但这种方式,在其他编译器中,不一定有用

比如我们想链接README.md文件中的如何使用

[如何使用](./README.md#如何使用)[如何使用](README.md#如何使用)

显示效果:

如何使用

插入图片

插入图片,是建立在链接的基础上的。

在链接的语法基础前,加上!进行区分即可。

![自定义图片名字](图片地址)
![wechat](imgs/wechat.jpg)

显示效果:

wechat

加强(加粗)

在文字的两端输入**__,可以使文字变成斜体

**我要粗了**(推荐,不用切换中英文,适用面更广)
__看我粗了__

显示效果:

我要粗了 看我粗了

符号指示

当我们需要强调一个符号或者一个函数的时候,可以在符号或者函数的两端使用`。

`看我不一样了`

显示效果:

看我不一样了