Markdown用法

311 阅读5分钟

一、关键用法

1、换行

  • shift + enter

    若需要换行不能直接使用enter,Markdown不会直接识别,须使用shift + enter才能够识别出换行。enter在Markdown中只能够识别是一个空格。 标题换行可直接使用enter
  • 空格 + 空格(2个空格以上均可) + enter

    在段落中使用。其中entertab都只算一个空格。
    有点头疼,上面被划掉的原因是,在正常的段落中使用不了。也有说上面那个只能运用在标题换行中,我测试了下,在标题换行中,直接使用enter也是可以的。暂时还没测出来,所以先划掉。如果有知道的,麻烦评论告诉我下

2、转义

如需显示特定的符号,使用反斜杠\转义特殊字符。

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

二、标题

1、使用=-标记一级二级标题

格式: 名称 + 换行(shift + enter) + 两个=-,但是经测试换行也可以直接使用enter。如下:

一级标题
==
二级标题
--

2、使用#号标记,多少个#表示多少级标题,最多6级

格式:# + 空格 +名称

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

三、段落

1、字体

格式:*_ + 名称 + *_。一个为斜体,两个为粗体,三个为粗斜体。如下:

*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

2、分割线

格式:一行中使用三个以上的*-_。如下

***
---
___

3、删除线

格式:~~ + 名称 + ~~。如下:

~~删除线~~

4、下划线

格式:<u> + 名称 + </u>。如下:

<u>下划线</u>

5、脚注

格式:段落中:需注明的文本[^注明名称]
随便写在哪,都在页脚显示:[^注明名称]:注明内容

需要注明的文本[^MarkDown]
[^MarkDown]:Markdown 是一种轻量级标记语言。

四、列表

MarkDown支持有序列表和无序列表

1、无序列表

格式:*+- + 空格 + 内容,如下:

* 星号
+ 加号
- 减号

2、有序列表

格式:数字 + . + 空格 + 内容,如下:

1. 第一项
2. 第二项

3、列表嵌套

格式: 在子列表中的选项添加四个空格

1. parent1
    + p1child1
    + p1child2
2. parent2
    + p2child1
    + p2child2

五、区块

1、 简单使用

格式:> + 空格 + 段落; 嵌套:>> + 空格 + 段落;

> Mark
>> Mark1
>>> Mark2
>>>> Mark3

2、区块与列表相结合

格式:区块中使用列表;列表中使用区块。如下

> 区块中使用列表
> 1. 有序
> + 无序
> 2. 有序
> - 无序

1. 列表中使用区块
    > 区块内容
    >> 区块内容
2. 列表中使用区块

六、代码

1、段落中的代码

格式:
` 内容文字 `

`ddd`

我怎么感觉这种不应该叫代码呢,有点注意的意思,并且使用这个不能进行换行,可能是在这个里面啥符号都不管用?还是我程序员思维,对代码的理解太过于死板了?

2、代码块

格式:4个空格 或 一个制表符(tab键);(这种结构不能指定语言)
用```包裹一段代码,并指定一种语言

七、链接

1、简单使用

格式:[链接名称](链接地址) 或者 <链接地址>
另外我刚发现如果你直接复制一个地址过来,掘金这边可以直接生成,不需要你自己去写代码

2、使用变量

格式:段落中:[链接名称][1]
文档末尾:[1]:链接地址

3、使用a标签

格式:<a href="超链接地址" target="_blank">超链接名</a>

八、图片

1、简单使用

格式:![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")
注:[]中为显示在图片下面的文字,()中为图片地址 + 图片标题(即移动到图片上时的文字显示) 突然发现[]中的文字并没有显示,为啥啊

2、使用变量

格式:段落中:![d][1]
文档末尾:[1]:链接地址

3、使用img标签(可自定义宽高)

格式:<img src="图片链接" wdith="" height="">

九、表格

1、简单使用

格式:
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容
第二行分割表头和内容。
-有一个就行,为了对齐,多加了几个
文字默认居左

  • 两边加:表示文字居中
  • 右边加:表示文字居右
    注:原生的语法两边都要用 | 包起来。此处省略
表头表头表头
内容内容内容
内容内容内容

十、流程图

这个太多了,而且也不会太常用,就不想写进来了,可以直接去Markdown + Mermaidmarkdown掘金 (juejin.cn)查看

十一、补充

1、支持的HTML标签

目前支持的 HTML 元素有:<kdb> <b> <i> <em> <sup> <sub> <br>等

终章

碎碎念前言(可不看)

最近感觉挺无聊的,小说看腻了,电视剧早就失去了兴趣,对游戏的兴趣一直都不大,当然,前提是没开始玩,一开始玩的那段时间,确实挺沉迷的。既然这样,开始学习吧,找点事干吧,好歹能充实下自己。
以前都是零碎的写在各种笔记软件里,准备有空再整理整理再发,然后就没下文了。包括其实这段时间在学习设计模式,但是也就发布了1篇博客园。
感觉不能这样下去,今天正好翻着有道云,想起了掘金,那就来这里整理记录吧。
想一出是一出,不知道能坚持多久。哈哈哈