Markdown 高级技巧
掌握了 Markdown 的基本语法后,你可能会发现还需要一些高级功能来满足更复杂的需求。本章将介绍 Markdown 的各种高级技巧,让你能够创建更专业、更丰富的文档。
任务列表
基本语法
markdown
- [ ] 未完成任务
- [x] 已完成任务效果:
- [ ] 未完成任务
- [x] 已完成任务
任务列表示例
markdown
## 学习计划
- [x] 学习 Markdown 基础语法
- [x] 掌握标题和文本格式
- [ ] 学习表格用法
- [ ] 学习高级技巧
- [ ] 完成实战项目效果:
学习计划
- [x] 学习 Markdown 基础语法
- [x] 掌握标题和文本格式
- [ ] 学习表格用法
- [ ] 学习高级技巧
- [ ] 完成实战项目
嵌套任务列表
markdown
- [ ] 主任务
- [x] 子任务 1
- [ ] 子任务 2
- [x] 子子任务 1
- [ ] 子子任务 2效果:
- [ ] 主任务
- [x] 子任务 1
- [ ] 子任务 2
- [x] 子子任务 1
- [ ] 子子任务 2
任务列表的应用
markdown
## 项目进度
### 后端开发
- [x] 数据库设计
- [x] API 接口开发
- [ ] 单元测试
- [ ] 文档编写
### 前端开发
- [ ] 页面设计
- [ ] 功能实现
- [ ] 样式优化
- [ ] 兼容性测试脚注
基本语法
markdown
这是一段需要脚注的文本[^1]。
[^1]: 这是脚注内容。效果:
这是一段需要脚注的文本^1。
多个脚注
markdown
Markdown 很强大[^1],它简单易学[^2],应用广泛[^3]。
[^1]: Markdown 是一种轻量级标记语言
[^2]: 由 John Gruber 于 2004 年创建
[^3]: 在技术文档、博客等领域广泛应用效果:
Markdown 很强大^1,它简单易学[^2],应用广泛[^3]。
^1: Markdown 是一种轻量级标记语言 [^2]: 由 John Gruber 于 2004 年创建 [^3]: 在技术文档、博客等领域广泛应用
脚注的最佳实践
markdown
## 技术规格
处理器:Intel Core i7[^cpu]
内存:16GB DDR4[^memory]
存储:512GB SSD[^storage]
[^cpu]: 第11代,主频 2.3GHz
[^memory]: 双通道,支持超频
[^storage]: NVMe 协议,读写速度 3500MB/s目录(TOC)
自动生成目录
一些编辑器支持自动生成目录:
markdown
[TOC]手动创建目录
markdown
## 目录
- [简介](#简介)
- [安装](#安装)
- [配置](#配置)
- [使用](#使用)
- [常见问题](#常见问题)
## 简介
...
## 安装
...GitHub 的目录
GitHub 会自动为 README 文件生成目录,但需要至少三个标题。
定义列表
基本语法(Markdown Extra)
markdown
术语
: 定义内容
另一个术语
: 定义内容HTML 方式
html
<dl>
<dt>HTML</dt>
<dd>超文本标记语言</dd>
<dt>CSS</dt>
<dd>层叠样式表</dd>
<dt>JavaScript</dt>
<dd>脚本语言</dd>
</dl>效果:
- HTML
- 超文本标记语言
- CSS
- 层叠样式表
- JavaScript
- 脚本语言
删除线
基本语法
markdown
~~删除的文本~~效果:
删除的文本
应用场景
markdown
## 版本更新
- [x] ~~添加新功能~~
- [ ] ~~修复 bug~~(已完成)
- [ ] 性能优化
- [ ] 文档更新
## 价格调整
原价:~~199元~~
现价:99元下标和上标
HTML 标签
markdown
H<sub>2</sub>O 是水。
E = mc<sup>2</sup>效果:
H2O 是水。 E = mc2
化学公式
markdown
## 化学方程式
2H<sub>2</sub>O → 2H<sub>2</sub> + O<sub>2</sub>
Na<sup>+</sup> + Cl<sup>-</sup> = NaCl键盘快捷键
基本语法
html
<kbd>Ctrl</kbd> + <kbd>S</kbd>
<kbd>Cmd</kbd> + <kbd>C</kbd>效果:
Ctrl + SCmd + C
复杂快捷键
html
<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>N</kbd>
<kbd>Alt</kbd> + <kbd>F4</kbd>效果:
Ctrl + Shift + NAlt + F4
应用示例
markdown
## 快捷键指南
- 保存:<kbd>Ctrl</kbd> + <kbd>S</kbd>
- 复制:<kbd>Ctrl</kbd> + <kbd>C</kbd>
- 粘贴:<kbd>Ctrl</kbd> + <kbd>V</kbd>
- 撤销:<kbd>Ctrl</kbd> + <kbd>Z</kbd>标记文本
高亮文本(部分编辑器)
markdown
==高亮文本==HTML 高亮
html
<mark>高亮文本</mark>效果:
高亮文本
缩写
HTML 方式
html
<abbr title="HyperText Markup Language">HTML</abbr>
<abbr title="Cascading Style Sheets">CSS</abbr>效果:
HTMLCSS
详情和摘要
HTML 标签
html
<details>
<summary>点击查看详情</summary>
这里是详细内容。
</details>效果:
点击查看详情
这里是详细内容。
代码折叠
html
<details>
<summary>点击展开代码</summary>
```python
def hello():
print("Hello, World!")
```
</details>引用属性
ID 属性(部分编辑器)
markdown
## 标题 {#custom-id}
引用:[跳转到自定义ID](#custom-id)HTML 方式
html
<h2 id="custom-id">标题</h2>
<a href="#custom-id">跳转到标题</a>Emoji 表情
Unicode 表情
markdown
😀 😃 😄 😁 😆
👍 👎 👏 👋 👐效果:
😀 😃 😄 😁 😆 👍 👎 👏 👋 👐
简写方式(部分编辑器)
markdown
:smile: :heart: :thumbsup: :rocket:效果:
😄 ❤️ 👍 🚀
Emoji 应用
markdown
## 状态更新
✅ 已完成
⏳ 进行中
❌ 失败
⚠️ 警告
ℹ️ 信息元数据
YAML 头部
markdown
---
title: 文章标题
date: 2024-01-15
tags: [Markdown, 教程]
author: 张三
---
正文内容...TOML 格式
markdown
+++
title = "文章标题"
date = 2024-01-15
tags = ["Markdown", "教程"]
+++
正文内容...自动链接增强
@提及(GitHub)
markdown
@octocat#问题引用(GitHub)
markdown
#123仓库引用(GitHub)
markdown
octocat/Hello-World特殊容器
提示框(特定编辑器)
markdown
> [!NOTE]
> 这是一个提示信息。
> [!TIP]
> 这是一个小技巧。
> [!WARNING]
> 这是一个警告。
> [!CAUTION]
> 这是一个注意事项。HTML 提示框
html
<div style="background: #e3f2fd; padding: 15px; border-left: 4px solid #2196F3;">
<strong>提示:</strong>这是一个提示信息
</div>效果:
提示:这是一个提示信息
进度条
HTML 方式
html
<div style="background: #eee; border-radius: 5px; overflow: hidden;">
<div style="background: #4CAF50; height: 20px; width: 70%;">
70%
</div>
</div>效果:
时间线
HTML 方式
html
<div style="border-left: 2px solid #ccc; padding-left: 20px; margin: 20px 0;">
<div style="margin-bottom: 20px;">
<strong>2024-01</strong>
<p>项目启动</p>
</div>
<div style="margin-bottom: 20px;">
<strong>2024-02</strong>
<p>完成开发</p>
</div>
<div>
<strong>2024-03</strong>
<p>正式发布</p>
</div>
</div>效果:
2024-01
项目启动
2024-02
完成开发
2024-03
正式发布
标签
HTML 标签
html
<span style="background: #e0e0e0; padding: 2px 8px; border-radius: 4px; font-size: 12px;">
Markdown
</span>
<span style="background: #e0e0e0; padding: 2px 8px; border-radius: 4px; font-size: 12px;">
教程
</span>效果:
Markdown 教程内联样式
文字颜色
html
<span style="color: red;">红色文字</span>
<span style="color: #007bff;">蓝色文字</span>效果:
红色文字蓝色文字
文字大小
html
<span style="font-size: 20px;">大字体</span>
<span style="font-size: 12px;">小字体</span>效果:
大字体小字体
实战示例
项目文档
markdown
# 项目文档
[TOC]
## 简介
本项目是一个...
---
## 快速开始
### 安装
```bash
npm install my-project配置
- 复制配置文件
- 修改配置项
- 保存设置
功能特性
- [x] 基础功能
- [ ] 高级功能
- [ ] 插件系统
API 参考
| 参数 | 类型 | 说明 |
|---|---|---|
| id | string | ID |
| name | string | 名称 |
常见问题
如何安装?
运行 npm install 命令
技术博客
markdown
# Markdown 高级技巧
## 📚 内容大纲
- [x] 任务列表
- [x] 脚注
- [x] 目录
- [ ] 图表
- [ ] 数学公式
---
## 💡 技巧一:任务列表
---
## 💡 技巧二:脚注
Markdown 很强大[^1]...
---
## 💡 技巧三:目录
...
---
## 🎯 总结
掌握了这些高级技巧...
[^1]: Markdown 由 John Gruber 创建小结
本章介绍了 Markdown 的各种高级技巧:
- 任务列表:创建可交互的待办事项
- 脚注:添加文档注释和引用
- 目录:自动生成文章导航
- 特殊格式:下标、上标、删除线
- HTML 增强:使用 HTML 标签扩展功能
- 自定义样式:添加颜色、大小等样式
- 结构化内容:时间线、进度条等
掌握这些高级技巧,可以让你的 Markdown 文档更加专业和功能丰富。
下一步: 学习 Markdown 数学公式 的编写方法。