Back to List

Markdown Basic Tutorial

blog.markdownTutorial.introduction

Markdown是一种轻量级标记语言,创建于2004年,目的是让人们能够使用易读易写的纯文本格式编写文档,然后转换成有效的HTML文档。Markdown的语法简洁明了,容易掌握,在网络写作中被广泛使用。

blog.markdownTutorial.basicSyntax

1. 标题

使用 # 符号可以创建不同级别的标题,从h1到h6:

# 一级标题 (H1)
## 二级标题 (H2)
### 三级标题 (H3)
#### 四级标题 (H4)
##### 五级标题 (H5)
###### 六级标题 (H6)

2. 强调

可以使用星号(*)或下划线(_)来强调文本:

  • 斜体文本: *斜体文本* 或 _斜体文本_
  • 粗体文本: **粗体文本** 或 __粗体文本__
  • 粗斜体文本: ***粗斜体文本*** 或 ___粗斜体文本___

3. 列表

无序列表可以使用星号、加号或减号作为列表标记:

* 项目1
* 项目2
  * 子项目1
  * 子项目2

- 项目1
- 项目2

+ 项目1
+ 项目2

有序列表使用数字加点:

1. 第一项
2. 第二项
3. 第三项

4. 链接

创建链接的语法为:[链接文本](URL)

[Any2Card官网](https://any2card.com)

5. 图片

插入图片的语法类似于链接,只是前面多了一个感叹号:![替代文本](图片URL)

![Any2Card Logo](/logo.jpeg)

6. 引用

使用 > 符号可以创建引用块:

> 这是一个引用
> 这是引用的第二行

7. 代码

行内代码可以用反引号包裹:

`这是行内代码`

代码块可以使用三个反引号或四个空格缩进:

```
function sayHello() {
  console.log("Hello, Markdown!");
}
```

8. 水平线

可以使用三个或更多的星号、减号或下划线来创建水平线:

***
---
___

blog.markdownTutorial.advancedSyntax

1. 表格

使用竖线和横线可以创建表格:

| 标题1 | 标题2 | 标题3 |
| ----- | ----- | ----- |
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |

2. 任务列表

可以创建带有复选框的任务列表:

- [x] 已完成任务
- [ ] 未完成任务
- [ ] 另一个未完成任务

3. 脚注

可以添加脚注来解释或引用内容:

这是一个带有脚注的文本[^1]

[^1]: 这是脚注的内容。

4. 删除线

使用两个波浪线可以添加删除线:

~~这是删除线文本~~

blog.markdownTutorial.examples

以下是一个简单的Markdown文档示例,展示了多种语法的组合使用:

# 我的Markdown示例

## 介绍

这是一个简单的**Markdown**示例,展示了*各种*语法元素的使用。

## 列表示例

### 无序列表
* 苹果
* 香蕉
* 橙子
  * 柚子
  * 柠檬

### 有序列表
1. 第一步
2. 第二步
3. 第三步

## 代码示例

以下是一个简单的JavaScript函数:

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}

console.log(greet('Markdown'));
```

## 引用示例

> Markdown是一种轻量级标记语言,让人们能够使用易读易写的纯文本格式编写文档。
> 
> — John Gruber (Markdown创造者)

## 表格示例

| 名称 | 类型 | 描述 |
| --- | --- | --- |
| 标题 | # | 用于创建标题 |
| 粗体 | ** 或 __ | 用于强调文本 |
| 链接 | [文本](URL) | 用于创建超链接 |

---

更多Markdown学习资源:
* [Markdown指南](https://www.markdownguide.org/)
* [GitHub Markdown基础](https://docs.github.com/cn/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)

这个教程涵盖了Markdown的基础和高级语法,通过学习和实践这些语法,您可以轻松地创建格式丰富的文档,用于博客、README文件、技术文档等多种场景。