Markdown 引用块
引用块用于突出显示重要信息、引用他人观点或创建视觉层次。
单级引用的使用
基本语法:
Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号:
markdown
> 区块引用
> 菜鸟教程
> 学的不仅是技术更是梦想显示结果:
区块引用 菜鸟教程 学的不仅是技术更是梦想
多行引用:
markdown
> 这是引用的第一行。
> 这是引用的第二行。
>
> 这是引用的第二段。简化写法:
只在第一行使用 > ,其余行会自动包含在引用中:
markdown
> 这是一个长引用,
包含多行内容,
只需要在第一行使用 > 符号。显示结果:
这是一个长引用, 包含多行内容, 只需要在第一行使用 > 符号。
多级嵌套引用
另外区块是可以嵌套的,一个 > 符号是最外层,两个 > 符号是第一层嵌套,以此类推:
markdown
> 最外层
> > 第一层嵌套
> > > 第二层嵌套显示结果:
最外层
第一层嵌套
第二层嵌套
实际应用示例:
markdown
> **用户反馈**:这个功能很有用!
>
> > **开发团队回复**:感谢您的反馈,我们会继续优化。
> >
> > > **项目经理补充**:预计下个版本会有更多改进。显示结果:
用户反馈:这个功能很有用!
开发团队回复:感谢您的反馈,我们会继续优化。
项目经理补充:预计下个版本会有更多改进。
区块中使用列表
区块中使用列表实例如下:
markdown
> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项显示结果:
区块中使用列表
- 第一项
- 第二项
- 第一项
- 第二项
- 第三项
列表中使用区块
如果要在列表项目内放进区块,那么就需要在 > 前添加四个空格的缩进。
列表中使用区块实例如下:
markdown
* 第一项
> 菜鸟教程
> 学的不仅是技术更是梦想
* 第二项显示结果:
- 第一项
菜鸟教程 学的不仅是技术更是梦想
- 第二项
引用块内的其他元素
引用块内可以包含几乎所有其他 Markdown 元素。
包含标题:
markdown
> ## 重要提醒
>
> 请在操作前仔细阅读文档,避免数据丢失。包含列表:
markdown
> ### 注意事项
>
> 1. 备份重要数据
> 2. 检查系统兼容性
> 3. 准备回滚方案
>
> - 测试环境验证
> - 生产环境部署
> - 监控系统状态包含代码:
markdown
> 要运行这个脚本,请使用以下命令:
>
> ···bash
> npm install
> npm start
> ···
>
> 执行后会在 `http://localhost:3000` 看到结果。包含链接和图片:
markdown
> 📚 **推荐阅读**
>
> 详细信息请参考 [官方文档](https://example.com)
>
> 引用的最佳实践
名言警句引用
markdown
> "在软件开发中,最昂贵的错误就是构建正确的系统错误的方式,或者构建错误的系统正确的方式。"
>
> — Barry Boehm,软件工程专家重要信息提示
成功提示:
markdown
> ✅ **成功**
>
> 配置已保存并生效。系统将在下次重启时应用新设置。警告信息:
markdown
> ⚠️ **警告**
>
> 此操作不可逆转,请确保已备份重要数据。错误信息:
markdown
> ❌ **错误**
>
> 连接数据库失败,请检查网络连接或联系系统管理员。信息提示:
markdown
> ℹ️ **提示**
>
> 首次使用需要进行账户验证,验证邮件已发送到您的邮箱。显示结果:
✅ 成功
配置已保存并生效。系统将在下次重启时应用新设置。
⚠️ 警告
此操作不可逆转,请确保已备份重要数据。
❌ 错误
连接数据库失败,请检查网络连接或联系系统管理员。
ℹ️ 提示
首次使用需要进行账户验证,验证邮件已发送到您的邮箱。
文档结构中的引用
章节摘要:
markdown
# 第一章:项目概述
> **本章要点**
>
> - 了解项目背景和目标
> - 掌握核心功能特性
> - 熟悉技术架构设计版本更新说明:
markdown
## v2.1.0 更新内容
> **重大变更**
>
> ⚠️ API 接口路径已调整,旧版本客户端需要更新
>
> 详见 [迁移指南](./migration-guide.md)