Markdown常用语法标记

常用标记

标题

#

• 根据文字前的 # 符号数量决定标题等级
• 多用标题，而不是列表进行排版，标题可以生成大纲视图进行目录跳转

列表

无序列表 * 或 -
有序列表 1.

• 输入符号后点击空格即可转成相应列表符号
• 跳出列表只需反复回车直到光标跳出列表范围

代码

代码块

```java
 //代码块
```

单选代码

`单选代码`

单选代码也可用于一些说明文字或插入的故事情节

文字描述

>

输入符号后敲击空格转换成文字描述形式
描述文字以灰色显示

文字样式

**需要加粗的文字** 加粗文字

***需要倾斜的文字*** 斜体文字

~~带删除线的文字~~ 删除文字

<kbd>文本框内容</kbd> 文本框内容

[说明文字](链接地址) 超链接

• 四个* 之间的内容会转换成加粗文字
• 六个 * 之间的内容会转换成倾斜文字
• 四个~ 之间的内容会转换成带删除线的文字

其他标记

分隔线

*** 或 ---

输入符号后回车即可转换成分隔线

待办事项

- [ ]

• [ ]

• 中括号里面如果是空格则为未选中，加 x 为选中
• - 空格[空格]空格 且需在行首才能正常转换
• 默认- 会解释成列表，可以不理，继续打出中括号即可变成待办事项

HTML

默认的文字样式可能不能满足正常的富文本需要或者特殊样式的实现，可以加入HTML标记配合CSS来设置样式，如：

红色强调文字

但为了使Html标记可以正常转换，需从行首在单独一行使用

常见问题

换行

Enter

常规换行使用回车即可，但此时可以看出行间距明显比较大，查看代码会发现其实是多增加了一行

Shift + Enter

使用组合键进行换行，不会增加一行来作为行间距，可用于一些说明文字块

图片

![备注文字](图片地址)

默认图片加载出来后会居中显示，我们可能更希望图片是配合着文字说明靠左会比较好，常用的方法有两种

• 一种是在 ! 之前加一个空格，这个可能跟编辑器相关，不一定通用
• 借用html标签配合css样式实现，同时可指定显示的宽高等
  如：
  <img src="https://gitee.com/zqunyan/ImgRepository/raw/master/img/20211019165303.png" width="" height="" style="float:left;"/>

推荐编辑器

那必须是 Typora 呀，而且用习惯了markdown语法，写CSDN等主流博客时编辑方式都可以换成markdown语法