markdown语法

2022-04-25 10:36:27

学习markdown？当然是为了做做笔记，脑子不好就只能动动手指啦。
以往做笔记是用的OneNote，但是一段事件下来，发现记在OneNote上的东西非常多，而且不方便查找。OneNote的Copy技能太强大了有木有。在现在日常开发节奏这么快的环境下，遇到不懂的技术基本都是度娘，google一顿操作，然后过两天忘了。悲哀呀，日常学习成果就这样遗忘在时间的角落了。本人表示很愤怒，本来就是我的，凭什么丢掉。
脑子不好只有靠别的弥补了，于是有了学习 markdown 并撰写博客的动机了。给自己的学习增加一个知识整理的过程，一个技术沉淀的载体。

1：标题

标题有六个级别，用 # 号来表示，有以下六个级别。

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

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2：列表

markdown中里列表也有“有序”和“无序”之分。
在文字前加上 - * + 就是无序列表，但是效果一样的，
加上数字如 1. 2. 3. 便是有序列表。
注：-、1. 和文本之间要保留一个字符的空格

- 无序列表1
- 无序列表2

* 无序列表1
* 无序列表2

+ 无序列表1
+ 无序列表2

无序列表1
无序列表2

无序列表1
无序列表2

无序列表1
无序列表2

1. 有序列表1
2. 有序列表2

有序列表1
有序列表2

3：表格

语法：

列：用 | 区分每列。

行：只能区分表头和表单内容，用 - 区分

对齐：再相应的方向上，用 :表示，如：
----- 默认对其：左对齐
----: 为右对齐
:---- 为左对齐
:---: 为居中对齐

| column | column | column | column |
| ---: | :----: | :----- | ---- |
|   row  | row | row | row |
|   row  | row |     | row |
|   row  | row | row |     |

column	column	column	column
row	row	row	row
row	row		row
row	row	row

4：链接

markdown中链接有两种：参考式、行内式。
链接的话可以是本地资源路径，相对路径和绝对路径都是可以的

行内式语法：[显示文本](链接地址 "title")，
链接弟子可以用<>包裹，也可以不用，效果式一样的
title属性的效果是鼠标悬浮到显示文本上会有提示信息，跟html是一样的。不想要的话，可以省略该属性。而属性值用单引号''、双引号“”、小括号()等任意一个符号包裹都是可以的，可以试一下。

参考式语法：
[显示文本][引用标识]，
[引用标签]: 链接地址 "title"，
参考式语法其实就是先定义好了再使用，多了个引用标签这样，方便我们集中管理引用，万一引用的资源url变了，方便修改了。
另外需要注意的是，参考式的链接地址和行内式的链接地址式不一样的，行内式的链接地址需要用小括号包裹，而参考式是不需要小括号的。

行内式链接(有title)：[这是百度的链接](www.baidu.com "百度")
行内式链接(无title)：[这是百度的链接](www.baidu.com)

行内式链接(符号：<>)：[这是百度的链接](<www.baidu.com> "百度")
行内式链接(符号：'')：[这是百度的链接](<www.baidu.com> '百度')
行内式链接(符号：())：[这是百度的链接](<www.baidu.com> (百度))

行内式链接(有title)：这是百度的链接
行内式链接(无title)：这是百度的链接
行内式链接(符号：'')：这是百度的链接
行内式链接(符号："")：这是百度的链接
行内式链接(符号：())：这是百度的链接

参考式链接：[这是百度的链接][mark-1]
参考式链接：[这是百度的链接][mark-2]
参考式链接：[这是百度的链接][mark-3]

[mark-1]: www.baidu.com "这是百度链接"
[mark-2]: www.baidu.com '这是百度链接'
[mark-3]: www.baidu.com (这是百度链接)

参考式链接：这是百度的链接
参考式链接：这是百度的链接
参考式链接：这是百度的链接

5：图片

markdown中图片也有两种：参考式、行内式。这和链接是一样的
路径的话可以是本地资源路径，相对路径和绝对路径都是可以的

行内式语法：[图片上传失败...(image-ef80a8-1535444198905)]
对比链接，也就多了个感叹号。

参考式语法：
![失效显示文本][引用标识]，
[引用标签]: 图片地址 "title"，
图片的参考式语法和链接的区别也是多了一个 ! 其他都是一样的。

行内式图片：
![这是百度的图片](http:https://yqfile.alicdn.com/img_2d8f060abfe954d3f513f3e2ec1b7b02.jpeg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "悬浮提示信息:message!!!")

行内式图片：

这是百度的图片

参考式图片：
![这是百度的图片][mark-img-1]
![这是百度的图片][mark-img-2]

[mark-img-1]:http://e.hiphotos.baidu.com/zhidao/wh%3D450%2C600/sign=08ce1447ceef76093c5e919b1bed8ffa/622762d0f703918fa4d62d10543d269758eec4e0.jpg "这是百度的图片"
[mark-img-2]:https://yqfile.alicdn.com/img_2d8f060abfe954d3f513f3e2ec1b7b02.jpeg "这是百度的图片"

参考式图片：

这是百度的图片

建议：行内式和参考式其实更应该使用参考式，因为图片地址和链接地址这种东西都是非常长的字符串，嵌入到文本内容当中很不优雅，会用凌乱的感觉，而使用参考式则没有这个问题，另外还可以统一管理url地址。也不用担心引用标签重复的问题。

6：代码块

写技术博客，最常用到的就是代码引用，markdown用 ` 来表示引用代码。

语法：

`单行引用`

``` 多行引用
多行引用
多行引用
```


单行代码引用：`LOGGER.info("message");`

多行代码引用：

@RunWith(SpringRunner.class)
@SpringBootTest
public class DemoApplicationTests {

    private static final Logger LOGGER = LoggerFactory.getLogger(DemoApplicationTests.class);

    @Test
    public void contextLoads() {

        LOGGER.info("message");

    }

}

7：区块引用

语法：用 > 来表示区块引用，有多少级就加多少个。只要是连续的，貌似没有限制。如果要另外增加相邻的同级，要空一行。

>一级引用
>>二级引用
>>>三级引用
>>>>四级引用
>>>>>五级引用

>>>>>>六级引用
>>>>>五级引用
>>>>>>>七级引用

>一级引用

一级引用

二级引用

三级引用

四级引用

五级引用

六级引用

五级引用

七级引用

一级引用

8：特殊字符

特殊markdown本质上其实是和html一样的语言，因此关于特殊字符和转移和html也是一样的，可以直接用编码展示特殊字符，参照HTML ASCII 参考手册

例如这些实体：
&#33;   &#34;   &#35;   &#36;   &#38;   &#60;   &#62;   &#169;  &#174;  &#165;

9：分割线

分割线可以用三个以上的 * 或 - 来表示。

------
被分割的内容
******

被分割的内容

10：文字处理

字体处理常用的就是高亮,颜色和加粗了，当然还有下划线，斜体，这些，删除一般都不会用了。颜色的话简书貌似也不支持，尚极简风格。不然的话可以用<font>标签来设置

高亮：用 == 包裹，高亮简书不支持，建议用 ` 代替

斜体：用 * 包裹

加粗：用 ** 包裹

下划线：用 ++ 包裹

删除：用 ~~ 包裹

段首空两格：用   

==高亮==
*斜体*
**加粗**
++下划线++
~~删线~~

&#8195;&#8195;段首空两格
段首空两格，段首空两格，段首空两格。

==高亮==
斜体
加粗
++下划线++
删线

段首空两格
段首空两格，段首空两格，段首空两格。

11：生成目录

使用[toc]就可以了，但是简书不支持。有道和csdn是可以支持的。

12：参考文献

参考文献的表示方式叫脚注或者尾注
语法：[^标签]
其实这个标签只是代码方便查看而给予的一个自定义方式，最终呈现在文本上的都是按全篇顺序排好序的文献引用。而且参考文献里欸包会自动加载到文档最魔为，分隔符是无法分割的

XXXXX[^1] XXXXXXXXXXXXXXXX,
XXXXX[^hello] XXXXXXXXXXXXXXXX,
XXXXX[^正经引用] XXXXXXXXXXXXXXXX,
XXXXX[^大学论文] XXXXXXXXXXXXXXXX

[^1]: 一个很普通的参考文献。
[^hello]: 这个很可能是自己的原创。
[^正经引用]: 某个知名博主的发表吧，引用一下。
[^大学论文]: 某某教授的论文，要认真标注好。

XXXXX^[1] XXXXXXXXXXXXXXXX,
XXXXX^[2] XXXXXXXXXXXXXXXX,
XXXXX^[3] XXXXXXXXXXXXXXXX,
XXXXX^[4] XXXXXXXXXXXXXXXX

一个很普通的参考文献。 ↩
这个很可能是自己的原创。 ↩
某个知名博主的发表吧，引用一下。 ↩
某某教授的论文，要认真标注好。 ↩

码农公寓

目录