How to use Markdown?

2024-06-16

Markdown,一种轻量级的标记语言,用于格式化文本。它的设计目标是使文本内容更易读、易写,同时生成的内容能直接转换为HTML格式。常用于写博客、文档、README文件等。

Markdown详细使用指南

1. 标题(Headings)

Markdown使用 #来表示标题,标题的级别通过#的数量来表示。#的数量越多,标题级别越低。

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

2. 段落和换行(Paragraphs and Line Breaks)

  • 段落:段落之间用空行分开。
  • 换行:如果要在段落内换行,可以在行尾加上两个或更多的空格,然后按Enter键。
这是第一段。

这是第二段。

3. 强调文本(Emphasis)

  • 加粗:用两个星号**或两个下划线__包裹文字。
  • 斜体:用一个星号*或一个下划线_包裹文字。
  • 加粗和斜体:用三个星号***或三个下划线___包裹文字。
**加粗文字**
*斜体文字*
***加粗且斜体文字***

4. 列表(Lists)

  • 无序列表:使用星号*、加号+或减号-
  • 有序列表:使用数字和点1.2.

无序列表:

* 项目一
* 项目二
* 项目三

有序列表:

1. 第一项
2. 第二项
3. 第三项
  • 链接:使用方括号[]表示链接文字,圆括号()表示链接地址。
  • 图片:在链接前加一个感叹号!

链接:

[点击这里访问Google](https://www.google.com)

图片:

![图片描述](图片链接)

6. 引用(Blockquotes)

引用用大于号>表示,可以嵌套多级引用。

> 这是一个引用。
> 
> 这是另一个引用。

7. 代码(Code)

  • 行内代码:用反引号`包裹代码。
  • 代码块:用三个反引号```表示多行代码块,可以指定代码语言以获得语法高亮。

行内代码:

这是 `print("Hello")` 的示例。

代码块:

    ```
    def hello_world():
        print("Hello, world!")
    ```

也可以指定语言:

    ```python
    def hello_world():
        print("Hello, world!")
    ```

8. 分割线(Horizontal Rules)

使用三个或更多的星号*、减号-或下划线_来创建分割线。

---

9. 表格(Tables)

Markdown支持表格,使用管道符号|来分隔列,使用破折号-来分隔表头和表体。

| 姓名   | 年龄 | 学科   |
|--------|------|--------|
| 张三   | 18   | 数学   |
| 李四   | 20   | 英语   |

10. 任务列表(Task Lists)

任务列表允许你显示待办事项,使用- [ ]表示未完成项,- [x]表示已完成项。

- [x] 完成作业
- [ ] 复习考试
- [ ] 看电影

11. 数学公式(Math Expressions)

在Markdown中,支持使用LaTeX语法书写数学公式。数学公式通常需要在支持数学渲染的环境中使用,例如GitHub、Jupyter Notebooks等。

  • 行内公式:使用$包围LaTeX代码。
  • 块级公式:使用$$包围LaTeX代码。

行内公式:

这是一个行内公式:$E = mc^2$。

块级公式:

$$
E = mc^2
$$

12. 高级功能

  • 脚注:Markdown支持通过脚注进行引用,通常在支持的编辑器中显示为超链接。
    这是一段带有脚注的文本[^1]。
      
    [^1]: 这是脚注的内容。
    
  • 自动链接:你可以直接写入URL,它会自动转换为可点击的链接。
    这是一个自动链接:https://www.example.com
    

Markdown综合示例

# 我的学习笔记

## 1. 学习目标
- 学习Markdown的基本语法
- 掌握如何插入公式

## 2. 公式示例

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

块级公式:
$$
E = mc^2
$$

## 3. 表格
| 姓名 | 年龄 | 学科   |
|------|------|--------|
| 张三 | 18   | 数学   |
| 李四 | 20   | 英语   |

## 4. 任务列表
- [x] 阅读Markdown文档
- [ ] 完成作业
- [ ] 复习数学


以上是Markdown的常见用法和一些高级功能。通过掌握这些基础语法,你就可以开始高效地编写格式化文本,适用于文档编写、博客文章以及学术论文等多种场景。