Markdown学习笔记

------------恢复内容开始------------

Markdown学习笔记

前言

Markdown是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。

Markdown编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。

Markdown 编写的文档后缀为 .md, .markdown

实际上是个非常简单、非常容易学习的排版语法。

当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息!

并且对代码和数学公式的支持比较友好,是一个很值得程序员学习的语言!

这里推荐一个全平台通用的编辑器[Typora ][https://typora.io/]
这里要说一下,不同编辑器对链接的格式是不一样的,不同网站的博客也是不一样的,这里以Typora编辑器显示的为准
主要是懒,不想再写一次,复制粘贴就完事了

标题

标题有两种书写模式

  • 使用 = 和 - 标记一级标题和和二级标题

  • 使用 # 号标记

使用使用 = 和 - 标记

语法标记如下,一般这种不太常用了解即可

我展示的是一级标题
=================

我展示的是二级标题
-----------------

使用 # 号标记

使用 #号可以表示1-6级的标题(不会有人6级标题还不够用吧......),多少个#号就代表有多少级标题(别忘了#号和后面的标题__要打一个空格__哦)

## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

段落格式

这个简单回车就好了,主要是要记录一下,在Markdown里面可以再段落末尾使用__两个空格__代表换行

字体

字体打法如下,可以用星号*,也可以用下划线_,看个人习惯,个数代表不同的样式,案例如下。

*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
~~删除文本~~

斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本
删除文本

分割线

使用三个以上的星号*,减号- ,下划线_ 可以创建一个分割线,他们之间不能有间隔(看是可以在星号*,减号- 之间插入空格),效果如下

***
---
___



链接

插入链接,一般了有三种

  • 本地图片链接

  • 网络图片链接

  • 网址链接

本地图片链接

语法规则如下,有两种写法(图片描述可以省略)

![图片描述](图片URL路径"title")

![图片描述](图片URL路径)

网络图片链接

语法规则如下(跟本地的有啥区别?

![图片描述](图片URL路径)

除此之外可以使用以下形式对图片地址使用变量

![logo][1]
[1]: 图片地址URL

自动链接

没啥好说的<>直接用这两个符号包裹就是了(这里要说一下,不同编辑器对链接的格式是不一样的,这里以Typora编辑器显示的为准),我就直接拿百度做例子算了,对了邮箱也可用这个来实现。

< 网址 >

<www.baidu.com>
除了上面的方法还可以使用下面这种形式给链接标注

[链接名称][链接地址]

[百度][www.baidu.com]

同样,这个也能用以下形式对链接地址使用变量

![文本][变量]
[变量]: 链接地址URL

代码块

这东西对于我们学计算机的真是利器(方便复制~),插入程序代码的方式是利用反引号符号(一般在ESC键下方,和 ~同一个键)包裹代码。(事实上直接复制粘贴代码也行,主要看Markdown的编辑器支不支持自动识别代码块)

单个反引号包裹单个代码,三个反引号包裹多行代码(在反引号后面可以输入代码名字进行标识,记得空格)样例如下

` 代码 `
​``` java
	代码
​```

写个Hello World玩玩

C/C++

#include <stdio.h>

int main()
{
    printf("Hello World");
    return 0;        
}

JAVA

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("hello world");
    }
}

Python

print 'Hello World'

人生苦短,我还是学Python吧

这里还有高级使用,后面再慢慢补吧

引用

这个似乎也没啥好说的>后面加上引用段落即可,并且多个>可以组成嵌套引用

>
>>
>>>

真好玩

好玩

引用还可以引用链接,代码块等

<www.baidu.com>

[百度][www.baidu.com]

#include <stdio.h>

int main()
{
    printf("Hello World");
    return 0;        
}

列表

列表主要有两种

  • 无序列表
  • 有序列表

无序列表

使用星号*,加号+,减号-,可以直接表示无序列表(记得加空格)

* 文字1
* 文字1
* 文字1

+ 文字2
+ 文字2
+ 文字2

- 文字3
- 文字3
- 文字3
  • 文字1
  • 文字1
  • 文字
  • 文字2
  • 文字2
  • 文字2
  • 文字3
  • 文字3
  • 文字3

有序列表

有序列表用数字加上.号来表示,不要忘了后面的标题要空一个格

1. 文字1
2. 文字2
  1. 文字1
  2. 文字2

嵌套列表

顾名思义就是有序列表和无序列表的套娃,只要在子列表的选项前面加四个空格就好了

* 无序列表1
    1. 有序列表1.1
    2. 有序列表1.2
* 无序列表2
    - 无序列表2.1
    - 无序列表2.2
  • 无序列表1
    1. 有序列表1.1
    2. 有序列表1.2
  • 无序列表2
    • 无序列表2.1
    • 无序列表2.2

并且无序列表跟有序列表可以同时使用

* 1. 混合列表
    1. 混合列表

列表的标题也支持各种字体

* 1. *斜体标题*
* 2. _斜体标题_
* 3. **粗体标题**
* 4. __粗体标题__
* 5. ***粗斜体标题***
* 6. ___粗斜体标题___
* 7. ~~删除标题~~
    1. 斜体标题
    1. 斜体标题
    1. 粗体标题
    1. 粗体标题
    1. 粗斜体标题
    1. 粗斜体标题
    1. 删除标题

列表不光可以单独使用,也可以使用其他的 Markdown 语法,包括标题、引用、代码区块等。

* 1. # 标题
* 2. >引用
* 3. ``` java
     print 'Hello World'
    1. 标题

    1. 引用

    1. print 'Hello World'
      
      

还有很多就不举例子了

注意事项

在使用列表时,只要是数字后面加上英文的点,就会无意间产生列表,比如2017.12.30 这时候想表达的是日期,有些软件把它被误认为是列表。

解决方式:在每个点前面加上\就可以了。(本质就是用转义字符嘛)

表格

Markdown表格使用 | 来分隔单元格,使用 - 来分隔表头和其它行。

| 表头 | 表头 |
| --- | --- |
| 单元格 | 单元格 |
| 单元格 | 单元格 |
表头 表头
单元格 单元格
单元格 单元格

对齐模式

-: 设置内容和标题栏右对齐
:- 设置内容和标题栏左对齐
:-: 设置内容和标题栏居中对齐

| 左对齐 | 右对齐 | 居中对齐 |
| :---- | ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

转义

Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,就要使用反斜杠转义特殊字符。
Markdown支持对以下特殊符号的转义:

符号 名称
\ 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号

例如:

**文本加粗**
\*\*正常显示星号\*\*

文本加粗

** 正常显示星号 **

插入 LaTeX 数学公式

可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。

$$
\mathbf{V}_1 \times \mathbf{V}_2 = 
\begin{vmatrix} 
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$

\[\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \\ \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\ \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\ \end{vmatrix} \]

更详细的数学公式可以参考

  1. Markdown中Latex数学公式基本语法
  2. Markdown编辑器使用Latex数学公式
  3. 常用数学符号的Latex表示方法

这里就不做深究

注脚

在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。 然后在文本的任意位置(一般在最后)添加脚注,脚注前必须有对应的脚注名字。

我是例子[^ 1]

[^1]: 例子

我是例子^ 1

引用和参考资料

Markdown语法图文全面详解(10分钟学会)

Markdown超详细使用说明

Markdown中Latex数学公式基本语法

Markdown编辑器使用Latex数学公式

常用数学符号的 Latex 表示方法

------------恢复内容结束------------

上一篇:pytorch的自动微分学习笔记


下一篇:一文学会在Markdown中编辑数学符号与公式