Markdown是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。掌握Markdown的排版和代码展示技巧,可以让你的文档更加清晰、专业。以下是一些实用的Markdown排版与代码展示技巧。

一、基本排版

1. 标题

Markdown使用#来创建标题,#的数量决定了标题的级别。例如:

# 一级标题
## 二级标题
### 三级标题

2. 段落

段落之间需要空行来区分。直接输入文本,Markdown会自动将其转换为段落。

3. 强调

使用星号*或下划线_来创建斜体或粗体:

  • 斜体:*斜体*_斜体_
  • 粗体:**粗体**__粗体__

4. 列表

  • 无序列表:使用-+*开头,例如:
  - 列表项1
  - 列表项2
  - 列表项3
  • 有序列表:使用数字和句点开头,例如:
  1. 列表项1
  2. 列表项2
  3. 列表项3

5. 引用

使用>来创建引用,例如:

> 这是一个引用

6. 分隔线

使用三个或更多短横线、星号或下划线来创建分隔线:

---




## 二、代码展示

### 1. 行内代码

使用反引号` `来标记行内代码:

```markdown
这是一个行内代码:`print("Hello, world!")`

2. 代码块

使用三个或更多反引号将代码包裹起来,并指定语言:

```python
print("Hello, world!")

这将显示一个语法高亮的Python代码块。

### 3. 代码折叠

在代码块前添加`<details>`标签,可以创建可折叠的代码块:

```markdown
<details>
<summary>显示/隐藏代码</summary>

```python
print("Hello, world!")


## 三、表格

使用竖线`|`和短横线`-`来创建表格:

```markdown
| 表头1 | 表头2 | 表头3 |
| --- | --- | --- |
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |

四、图片

使用![替代文本](图片链接)来插入图片:

![Markdown](https://example.com/markdown.png)

五、链接

使用[链接文本](链接地址)来创建链接:

[访问官网](https://example.com)

六、总结

掌握Markdown的排版与代码展示技巧,可以帮助你轻松创建美观、专业的文档。通过不断实践,你会越来越熟练地使用Markdown,让写作变得更加高效。