Markdown 完整指南

Markdown 是一种轻量级标记语言，它允许你使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML。这篇文章将为你详细介绍 Markdown 的各种语法元素。

基础语法

标题

Markdown 支持六级标题，使用 # 符号：

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

段落和换行

段落之间用空行分隔。如果你想在段落内换行，可以在行尾添加两个或更多空格，然后按回车键。

这是第一个段落。

这是第二个段落。

强调

粗体文本 使用 **文本** 或 __文本__
斜体文本 使用 *文本* 或 _文本_
粗斜体文本 使用 ***文本***
~~删除线文本~~ 使用 ~~文本~~

列表

无序列表

使用 -、+ 或 * 创建无序列表：

第一项
第二项
- 嵌套项目
- 另一个嵌套项目
第三项

有序列表

使用数字和点创建有序列表：

第一项
第二项
1. 嵌套项目
2. 另一个嵌套项目
第三项

链接

图片

高级语法

代码

内联代码

使用反引号包围代码：const greeting = "Hello, World!"

代码块

使用三个反引号创建代码块：

// JavaScript 示例
function greet(name) {
  return `Hello, ${name}!`;
}

const message = greet("World");
console.log(message);

# Python 示例
def greet(name):
    return f"Hello, {name}!"

message = greet("World")
print(message)

/* CSS 示例 */
.button {
  background-color: #007bff;
  color: white;
  padding: 10px 20px;
  border: none;
  border-radius: 4px;
  cursor: pointer;
  transition: background-color 0.3s ease;
}

.button:hover {
  background-color: #0056b3;
}

引用

这是一个引用块。

引用可以包含多个段落。

这是嵌套引用。

表格

功能	支持	备注
响应式设计	✅	完全支持
深色模式	✅	自动检测
多语言	✅	中英文
SEO优化	✅	完整支持
代码高亮	✅	多语言支持

分割线

使用三个或更多的连字符、星号或下划线：

任务列表

完成项目搭建
实现基础功能
添加高级功能
优化性能

脚注

这是一个包含脚注的文本¹。

扩展语法

数学公式

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

块级公式：

$$ \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} $$

高亮文本

==高亮文本== 使用 ==文本==

下标和上标

H2O (下标)
X^2^ (上标)

最佳实践

1. 文档结构

使用清晰的标题层级
合理使用列表和段落
添加适当的空行提高可读性

2. 代码规范

为代码块指定语言
使用有意义的变量名
添加必要的注释

3. 图片优化

使用有描述性的替代文本
选择合适的图片尺寸
考虑加载性能

4. 链接管理

使用描述性的链接文本
检查链接的有效性
考虑在新窗口打开外部链接

写作技巧

内容组织

开门见山 - 在开头明确说明文章的主题
逻辑清晰 - 使用标题和子标题组织内容
重点突出 - 使用强调和列表突出关键信息
总结收尾 - 在结尾总结要点

可读性优化

使用短句和简单词汇
避免过长的段落
合理使用标点符号
添加适当的空白空间

工具推荐

Markdown 编辑器

Typora - 所见即所得的编辑器
Mark Text - 开源的实时预览编辑器
VS Code - 配合插件使用

在线工具

Markdown Guide - 官方指南
Dillinger - 在线编辑器
StackEdit - 功能丰富的在线编辑器

结论

Markdown 是一个强大而简洁的标记语言，掌握它可以让你更高效地创作内容。通过本指南，你应该已经了解了 Markdown 的主要语法和最佳实践。

记住，好的写作不仅仅是语法正确，更重要的是内容的质量和可读性。继续练习，你会发现 Markdown 是一个非常棒的写作工具！

相关文章:

这是脚注的内容。 ↩