13 Markdown基础教程

13 Markdown基础教程

什么是Markdown

Markdown是一种轻量级的标记语言,允许你使用简单的符号来格式化文本。这使得撰写和阅读文档变得更为便捷。

常用格式化

文字样式

  • 加粗:使用**__围绕文本,例如 **加粗文本**
  • 斜体:使用*_围绕文本,例如 *斜体文本*
  • 删除线:使用~~围绕文本,例如 ~~删除线文本~~

列表

  • 无序列表使用*-+

    1
    2
    3
    4
    - 项目1
    - 项目2
    - 子项目1
    - 子项目2
  • 有序列表使用数字加.

    1
    2
    3
    4
    1. 第一项
    2. 第二项
    1. 子项1
    2. 子项2

链接和图片

  • 链接格式:[链接文本](URL),例如 [Google](https://www.google.com)
  • 图片格式:![替代文本](图片URL),例如 ![Markdown Logo](https://markdown-here.com/img/icon256.png)

代码

  • 行内代码使用反引号`包围,例如 这是 `代码` 示例
  • 块级代码使用三个反引号:
    1
    2
    3
    4
    ```
    这是一个代码块示例
    console.log("Hello, World!");
    ```

表格

Markdown支持基础表格格式:

1
2
3
4
| 列1   | 列2   | 列3   |
|-------|-------|-------|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |

引用

使用>来创建引用:

1
2
> 这是一个引用示例。
> 可以包含多行文本。

分隔线

使用三个或更多的-*_可产生分隔线:

1
---

代码高亮

在实现代码高亮时,需要指定语言:

1
2
3
4
```python
def hello_world():
print("Hello, World!")
```

公式

Markdown也支持LaTeX格式的数学公式:

  • 行内公式:例如 $E=mc^2$。
  • 块级公式:
    $$
    E=mc^2
    $$

实例

下面是一个完整的Markdown示例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# Markdown示例文档

## 文字样式
这是一段**加粗文本**和一段*斜体文本*

## 列表
- 项目一
- 子项目一
- 项目二

## 链接和图片
欢迎访问 [百度](https://www.baidu.com),以下是Markdown Logo:
![Logo](https://markdown-here.com/img/icon256.png)

## 代码
这是一个行内代码的示例:`` `代码` ``。

遵循以上格式,你可以轻松撰写格式丰富的Markdown文档。

14 Markdown指南

14 Markdown指南

小节 内容描述
Markdown简介 介绍Markdown的基本概念和用途
基本语法 学习Markdown的基本语法,如标题、列表、链接等
标题 如何创建不同级别的标题
列表 有序和无序列表的语法及用法
链接和图片 创建链接和插入图片的语法
强调 使用*_来加粗和斜体文本
代码块 如何插入行内代码和块级代码
引用 使用引用语法来引用他人观点
表格 创建和使用Markdown表格格式
公式 如何在Markdown中插入数学公式
扩展语法 Markdown的一些扩展语法如任务列表和图表
实践案例 提供实际的Markdown示例及应用场景

Markdown简介

Markdown是一种轻量级的标记语言,常用于格式化文本,使其在网页上表现得更为美观。它的语法简单易懂,非常适合快速撰写文章。

基本语法

Markdown的基本语法包括标题、列表、链接、图片等,以下是常见的用法:

标题

创建标题时,可以使用#符号,数量代表标题级别。例如:

1
2
3
# 一级标题
## 二级标题
### 三级标题

列表

创建无序列表使用*-+,有序列表使用数字加点。例如:

1
2
3
4
5
- 无序列表项1
- 无序列表项2
- 嵌套项
1. 有序列表项1
2. 有序列表项2

链接和图片

插入链接的格式为[链接文本](网址),插入图片则在前面加一个!

1
2
[百度](https://www.baidu.com)
![示例图片](https://example.com/image.jpg)

强调

使用*_来进行文本的加粗和斜体。例如:

1
2
*斜体文本*
**加粗文本**

代码块

行内代码使用反引号来包围,例如代码`。块级代码使用三个反引号:

1
2
```
这是一个块级代码
1
2
3
4
5
6
7

### 引用

引用他人观点时,可以使用`>`符号,例如:

```markdown
> 这是一个引用文本。

表格

Markdown支持简单的表格语法:

1
2
3
| 列1 | 列2 |
|-----|-----|
| 数据1 | 数据2 |

公式

在Markdown中插入数学公式时,使用$来包围,例如行内公式使用一个对$符号,块级公式使用两个对$符号:

行内公式示例:$E=mc^2$

块级公式示例:

$$
a^2 + b^2 = c^2
$$

扩展语法

一些Markdown编辑器支持扩展语法,例如任务列表和图表。例如:

1
2
- [ ] 任务未完成
- [x] 任务已完成

实践案例

以下是一个示例Markdown文档,结合了以上的语法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 我的Markdown文档

这是一个简单的Markdown示例,包含了基本的语法。

## 主要内容

- **语法学习**
- 提升文档格式化能力

### 示例链接

访问 [Google](https://www.google.com)

### 数学公式

行内公式示例:$a + b = c$

块级公式示例:

$$
E = mc^2
$$

通过以上内容,可以帮助您快速上手Markdown,进行更丰富的文本编辑和格式化。

15 Markdown教程

15 Markdown教程

Markdown简介

  • 什么是Markdown
  • Markdown的优点

基础语法

  • 标题
    • 使用#表示标题等级
    • 示例:# 一级标题
  • 段落与换行
    • 段落之间空行分隔
    • 使用两个空格进行换行

字体样式

  • 粗体与斜体
    • 粗体:**文本**__文本__
    • 斜体:*文本*_文本_
    • 示例:**加粗文本** 变为 加粗文本
  • 删除线
    • 使用~~文本~~
    • 示例:~~删除线文本~~ 变为 删除线文本

列表

  • 有序列表
    • 使用数字加点,例如 1. 第一项
  • 无序列表
    • 使用*-+
    • 示例:
      1
      2
      * 项目一
      * 项目二

链接与图片

  • 超链接
    • 使用[链接文本](URL)
    • 示例:[百度](https://www.baidu.com)
  • 图片
    • 使用![替代文本](图片URL)
    • 示例:![示例图](https://example.com/image.png)

引用与代码块

  • 引用
    • 使用>表示引用
    • 示例:
      1
      > 这是一段引用
  • 行内代码
    • 使用`表示行内代码
    • 示例:`代码` 变为 代码
  • 块级代码
    • 使用三个反引号包围代码块
    • 示例:
      1
      2
      3
      ```
      代码块
      ```

表格

  • 创建表格
    • 使用|-创建表格
    • 示例:
      1
      2
      3
      | 头部1 | 头部2 |
      |-------|-------|
      | 内容1 | 内容2 |

数学公式

  • 行内公式
    • 使用一对$表示
    • 示例:$E=mc^2$
  • 块级公式
    • 使用两对$表示
    • 示例:
      $$
      E = mc^2
      $$

扩展语法

  • 任务列表
    • 使用- [ ]- [x]表示未完成和已完成任务
    • 示例:
      1
      2
      - [ ] 未完成的任务
      - [x] 已完成的任务

实践案例

  • 编写一个简单的Markdown文档
    • 使用以上语法组合创建一个完整的文档
  • Markdown转换为HTML
    • 使用工具将Markdown转为HTML展示

结语

  • Markdown的应用场景
  • 进一步学习资源