markdown知识点

最新推荐文章于 2024-10-02 19:58:32 发布

qq_44772506

最新推荐文章于 2024-10-02 19:58:32 发布

阅读量56

点赞数

文章标签： github

本文链接：https://blog.csdn.net/qq_44772506/article/details/130232823

版权

本文详细介绍了Markdown的基本语法，包括标题、段落、换行、强调、斜体、块引用、列表、代码区域、链接、图片、代码高亮、水平线、链接图像、转义字符、HTML最佳实践、表格、格式化表格文本、围栏代码块、脚注、标题ID、删除线、表情符号和自动URL链接等内容，是Markdown初学者的全面指南。

摘要由CSDN通过智能技术生成

# markdown 基本语法

## 标题

```markdown

# 我是一级标题

## 我是二级标题

### 我是三级标题

#### 我是四级标题

##### 我是五级标题

###### 我是六级标题

```

## 段落

> 要创建段落，请使用空行分隔一行或多行的文本

我是一个段落



我是真的很喜欢使用markdown

## 换行符

> 要创建换行符或换行符（`<br>`),请以两个或多个空格结束一行，然后键入return

这是第一行。<br> 这是第二行

## 强调（加粗）

> 文本加粗，重点突出

我喜欢**粗体**字<br>

妈妈 __我爱你__

## 斜体

>要是文本变为斜体，请在单词或短语前后添加一个星号或下划线

>为了强调单词中间的斜体，请在字母周围添加一个不带空格的星号


我也特别喜欢*斜体*字

是吗，真的喜欢 _斜体字_ 吗？

## 块引用

> 要创建块引用，请`>` 在段落前添加一个

```markdown

> 我是一个块引用

```

渲染的输出如下所示：

> 我是一个块引用

## 带有多个段落的块引用

>块引用可以包含多个段落。`>`在段落之间的空白行上添加一个

```markdown

>我是Array老师

>

>全宇宙最帅气的男神^_^

```

渲染的输出如下所示：

>我是Array老师

>全宇宙最帅气的男神^_^

## 嵌套块引用

> 块引用可以嵌套。 >>在要嵌套的段落前面添加一个。

```markdown

>我是Array老师

>

>>全宇宙最帅气的男神^_^

```

渲染的输出如下所示：

>我是Array老师

>>全宇宙最帅气的男神^_^

>>>张皇

## 带有其他元素的块引用

> Blockquotes 可以包含其他markdown 格式的元素

> 所有元素都可以使用，您需要尝试看看哪些元素有效

```markdown

> ### Markdown的语法学习

> - 什么是Markdown?

> - 为什么要用Markdown?

> - 支持Markdown的应用程序和组件，工具

> - Markdown文件的工作原理

> - Markdown的基本语法

>

> **真的真的** 是太好用了，我今天就开始 **用起来**  

```

渲染的输出如下所示：

> ### Markdown的语法学习

> - 什么是Markdown?

> - 为什么要用Markdown?

> - 支持Markdown的应用程序和组件，工具

> - Markdown文件的工作原理

> - Markdown的基本语法

> **真的真的** 是太好用了，我今天就开始 **用起来**

## 有序列表

> 创建有序列表

1. 第一项

2. 第二项

3. 第三项

1. 第一项

2. 第二项

2. 第三项

## 无序列表

> 要创建无序列表，请在行项目前添加破折号-、星号*或加号+。缩进一项或多项创建嵌套列表

- 第一项

- 第二项

- 第三项  

  - 缩进第一项

  - 缩进第二项

    - 缩进第三项  

- 第四项

### 块引用

- 我是第一个列表项

- 我是第二个列表项

> 插入块引用

- 我是第三个列表项

## 图片

![壁纸](./assets/壁纸1.jpg)

```markdown

图片语法

![壁纸](./assets/壁纸1.jpg)

```

## 代码区域

>要将单词或短语表示为代码，请将其括在反引号(`)中。

语义元素举例：`<form>`,`<nav>`,`<header>`等

## 转义反引号

> 如果要表示为代码的单词或短语包含一个或多个反引号，则可以通过将单词或短语括在双反引号中对其进行转义

``use `code` in your Markdown file.``

## 代码块

<html>

</html>

```

<html>

    <head></head>

</html>

```

## 代码块的高亮

```html

<!DOCTYPE html>

<html lang="en">

<head>

    <meta charset="UTF-8">

    <meta http-equiv="X-UA-Compatible" content="IE=edge">

    <meta name="viewport" content="width=device-width, initial-scale=1.0">

    <title>Document</title>

</head>

<body>

</body>

</html>

```

## 水平线

> 要创建谁水平线，请在一行上单独使用三个或更多星号（***),破折号（---），或下划线（___)

```markdown

***

---

___

```

渲染的输出如下所示：

***

---

___

## 链接

> 要创建链接，请将连接文本括在括号中，然后紧跟在括号中的URL

```markdown

我喜欢的博客是：[arry老师的博客](http://arryblog.com)

```

渲染的输出如下所示：

我喜欢的博客是：**[arry老师的博客](http://arryblog.com "arry老师博客")**

## URL和电子邮件

> 要将URL和电子邮件地址快速转换为链接，请将其括在尖括号中

```markdown

<http://arryblog.com>

<arry@163.com>

```

渲染的输出如下所示：

<http://arryblog.com>

<arry@163.com>

## 图片

> 要添加图像，请添加感叹号（！），后跟括号中的替代文本，以及括号中的图像资源的路径或URL。您可以选择在路径或URL后添加引号中的标题

![壁纸](assets/壁纸1.jpg "壁纸")

## 链接图像

> 要添加指向图片的链接，请将图像的Markdown括在括号中，然后将链接添加到括号中。

```markdown

[![壁纸](assets/壁纸1.jpg "壁纸")](http://arryblog.com)

```

**渲染的输出如下所示：**

[![壁纸](assets/壁纸1.jpg "壁纸")](http://arryblog.com)

## 转义字符

> 要显示原本用于在markdown文档格式化文本的文字字符，请在字符前面添加反斜杠（\）

```markdown

* 如果没有反斜杠，这将是项目的符号

- 无序列表

```

**渲染的输出如下所示：**

\* 如果没有反斜杠，这将是项目的符号

\- 无序列表

* 如果没有反斜杠，这将是项目的符号

- 无序列表

### HTML最佳实践

块级元素中不能使用markdown语法

## 表格

> 要添加表格，请使用三个或更多连字符来创建每一列的标题，并使用竖线分隔每一列。为了兼容性，您还应该在行的任一端添加一个管道

```markdown

|语法|描述|

|-----|-----|

|标题|标题|

|段落|段落|

```

**渲染的输出如下所示：**

|语法|描述|

|-----|-----|

|标题|标题|

|段落|段落|

### 表格内容的对齐方式

> 您可以通过在标题行内连字符的左侧、右侧或两侧添加冒号来将列中的文本向左、向右或居中对齐

```markdown

|基本语法|描述说明|测试方法|

|:---|:---:|---:|

|标题|标题|标题1|

|段落|段落|标题2|

```

**渲染的输出如下所示：**


|基本语法|描述说明|测试方法|

|:---|:---:|---:|

|标题|标题|标题1|

|段落|段落|标题2|

## 格式化表格中的文本

> 您可以设置表格中文本的格式。例如，您可以添加链接，代码（仅反引号（`）中的单词或短语，而不是代码块）和强调。

> 不能使用标题、块引用、列表、水平线、图像或大多数 HTML 标记。

|基本语法|描述说明|测试方法|

|:---|:---:|---:|

|[标题](http://arryblog.com)|标题|标题1|

|段落|段落|标题2|

## 围栏代码块

> 基本的 Markdown 语法允许您通过将行缩进四个空格或一个制表符来创建代码块。

````markdown

```

{

  "firstName": "John",

  "lastName": "Smith",

  "age": 25

}

```

````

**渲染的输出如下所示：**

```json

{

  "firstName": "John",

  "lastName": "Smith",

  "age": 25

}

```

## 脚注

> 若要创建脚注引用，请在方括号[]内添加插入符号和标识符。标识符可以是数字或单词，但不能包含空格或制表符。标识符仅将脚注引用与脚注本身相关联 — 在输出中，脚注按顺序编号。[^1]

> 在括号内使用另一个插入符号和数字添加脚注，并带有冒号和文本。您不必在文档末尾添加脚注。您可以将它们放在除列表、块引号和表格等其他元素之外的任何位置。[^1]: My footnote.

这是一个简单的脚注,[^1],这是一个更长的脚注。[^2]

[^1]:arry老师很棒

[^2]:秦时明月好看

## 标题ID

> 许多Markdown处理器支持标题的自定义 ID — 一些 Markdown 处理器会自动添加它们。通过添加自定义 ID，您可以直接链接到标题并使用 CSS 对其进行修改。若要添加自定义标题 ID，请将自定义 ID 括在与标题相同的行上的大括号中。

```markdown

### 我是标题标签{#h-id}

```

HTML如下所示：

```html

<h3 id="custom-id">My Great Heading</h3>

```

## 删除线

> 删除线是单词前后紧挨两个波浪~~

```markdown

~~秦时明月好看~~

```

**渲染的输出如下所示：**

~~秦时明月好看~~

## 表情符号

> 在大多数情况下，您只需从表情百科等来源复制表情符号并将其粘贴到文档中即可。许多 Markdown 应用程序将自动以 Markdown 格式的文本显示表情符号。从 Markdown 应用程序导出的 HTML 和 PDF 文件应显示表情符号。

## 使用表情符号简码

所有的表情符号：

http://github.com/markdown-it/markdown-it-emoji/blob/master/lib/data/full.json

去露营啦！ :tent: 快回来

## 强调

```markdown

==学习商业项目==研发解决方案，就来爱编程

```

<mark>学习商业项目<mark>研发解决方案，就来爱编程

##自动URL链接

arry老师博客：http://arryblog.com

## 禁用自动URL链接

## 更多用法

> 如果不希望自动链接某个 URL，可以通过将URL 表示为带有反引号的代码来删除该链接

`http://arryblog.com`

vuepress

## 常见企业开发新项目中的README文档模板

http://readme.so

qq_44772506

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
复制链接

分享到 QQ

分享到新浪微博

扫一扫