返回首页

Markdown完全指南:轻量级标记语言的魅力

📅 发布日期:2025年04月15日 👁️ 阅读量:72 📚 分类:tech
边学边练! 点击这里 使用我们的Markdown在线预览工具,实时体验Markdown的魅力。
目录

1. Markdown简介

Markdown是一种轻量级标记语言,由John Gruber于2004年创建,目标是让文档的编写和阅读都变得更加简单。它使用纯文本格式编写文档,然后转换成有效的HTML文档,适用于网站内容、笔记、书籍、演示文稿等多种场景。

Markdown的设计理念是"易于编写,易于阅读",即使是未经渲染的原始文本也应该是可读的,这与其他标记语言如HTML形成鲜明对比。

Markdown的主要优势包括:

2. 基础语法

Markdown的基础语法非常简单,以下是最常用的几种格式:

2.1 标题

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

另外,还可以使用下划线的方式创建一级和二级标题:

一级标题
=========

二级标题
---------

2.2 段落与换行

这是第一段文字。

这是第二段文字。

这行末尾有两个空格,  
所以这里会换行但仍在同一段落内。

2.3 强调

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

2.4 列表

无序列表:
* 项目1
* 项目2
  * 子项目2.1
  * 子项目2.2
* 项目3

有序列表:
1. 第一项
2. 第二项
3. 第三项
在有序列表中,数字的实际值并不重要,Markdown会自动按顺序编号。

2.5 链接

[链接文本](URL "可选的标题")
[GitHub](https://github.com "全球最大的代码托管平台")

2.6 图片

![替代文本](图片URL "可选标题")
![Markdown Logo](https://markdown-here.com/img/icon256.png "Markdown Logo")

2.7 引用

> 这是一个引用。
> 
> 这是引用的第二段。
>> 这是嵌套引用。

2.8 代码

行内代码:`print("Hello")`

```python
def say_hello():
    print("Hello, World!")```

2.9 水平线

***

3. 高级语法

3.1 表格

| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 单元格 |  单元格  | 单元格 |

3.2 任务列表

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

3.3 脚注

这是一个脚注引用[^1]

[^1]: 脚注内容

3.4 定义列表

术语1
: 定义1

术语2
: 定义2

3.5 自动链接

<https://www.example.com>
<email@example.com>
不同的Markdown实现可能支持不同的高级语法。

4. Markdown扩展

4.6 LaTeX支持

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

独立公式:
$$
\frac{d}{dx}e^x = e^x
$$

5. 常用工具与平台

5.1 编辑器

6. 最佳实践

6.4 混合使用HTML

<div class="warning">
    慎用HTML
</div>

7. 总结

"Markdown的美妙之处在于,它既是一种写作工具,也是一种思考工具。它让你专注于内容的结构和逻辑,而不是外观。"

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

文章标签: Markdown 标记语言 文档编写 技术写作 GitHub 博客

💬 评论区 1

S
sfdf
04-15 22:35

啊实打实

发表评论

👤
昵称将会公开显示
支持Markdown语法,可使用 # 标题、**粗体**、*斜体*、`代码` 等
📋
评论须知:
  • 评论提交后需要经过管理员审核才会显示
  • 请遵守互联网法规,文明发言
  • 评论支持基本Markdown语法,可适当排版