Markdown 基础文本格式

1. 引言

基础文本格式是 Markdown 中用于强调和格式化文本的基本元素，包括斜体、粗体、删除线等。

2. 斜体

3.1 语法

使用 * 或 _ 包裹文本，实现斜体效果。

-
-

3.2 渲染效果

斜体文本 斜体文本

3. 粗体

4.1 语法

使用 ** 或 __ 包裹文本，实现粗体效果。

-
-

4.2 渲染效果

粗体文本 粗体文本

4. 粗斜体

5.1 语法

使用 *** 或 ___ 包裹文本，实现粗斜体效果。

-
-

5.2 渲染效果

粗斜体文本 粗斜体文本

5. 删除线

6.1 语法

使用 ~~ 包裹文本，实现删除线效果（GFM 扩展语法）。

~

6.2 渲染效果

删除线文本

6. 下划线

7.1 语法

Markdown 本身不支持下划线语法，但可以使用 HTML 的 <u> 标签实现。

<u>下划线文本</u>

7.2 渲染效果

下划线文本

7. 上标与下标

8.1 语法

Markdown 本身不支持上标和下标语法，但可以使用 HTML 标签实现：

• 上标：使用 <sup> 标签
• 下标：使用 <sub> 标签

2<sup>2</sup> = 4
H<sub>2</sub>O

8.2 渲染效果

2² = 4 H₂O

8. 高亮文本

9.1 语法

高亮文本是 GitHub Flavored Markdown (GFM) 的扩展语法，使用 == 包裹文本：

=

9.2 渲染效果

==高亮文本==

9. 脚注

10.1 语法

脚注用于为文本添加注释或参考信息：

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

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

10.2 渲染效果

这是一个带有脚注的文本¹。

8. 行内代码

9.1 语法

使用 ` 包裹文本，实现行内代码效果。

`行内代码`

9.2 渲染效果

行内代码

9. 常见问题与解决方案

10.1 格式不生效

问题描述：文本格式不生效，显示为普通文本。 原因分析：标记符使用不正确或缺少标记符。 解决方案：确保使用正确的标记符包裹文本，如 *斜体*、**粗体** 等。

10.2 标记符冲突

问题描述：当文本中包含 * 或 _ 等特殊字符时，可能与格式标记符冲突。 解决方案：使用反斜杠 \ 转义特殊字符，如 \*、\_。

10.3 嵌套格式

问题描述：嵌套使用格式标记符时，可能导致格式混乱。 解决方案：确保嵌套的标记符正确匹配，如 ***粗斜体***。

10. 总结与最佳实践

11.1 核心概念

• 斜体：使用 * 或 _ 包裹文本
• 粗体：使用 ** 或 __ 包裹文本
• 粗斜体：使用 *** 或 ___ 包裹文本
• 删除线：使用 ~~ 包裹文本
• 下划线：使用 HTML 的 <u> 标签
• 上标：使用 HTML 的 <sup> 标签
• 下标：使用 HTML 的 <sub> 标签
• 高亮文本：使用 == 包裹文本（GFM 扩展）
• 脚注：使用 [^1] 标记
• 行内代码：使用 ` 包裹文本

11.2 最佳实践

1. 格式使用

• 斜体：用于强调或突出显示
• 粗体：用于重点内容或标题
• 粗斜体：用于特别重要的内容
• 删除线：用于表示已删除或过时的内容
• 上标/下标：用于数学公式或化学符号
• 高亮文本：用于特别需要注意的内容
• 脚注：用于添加补充说明
• 行内代码：用于代码片段、命令或变量名

2. 标记符选择

• 统一使用一种标记符风格，如统一使用 * 而不是混合使用 * 和 _
• 保持标记符与文本之间没有空格，如 *斜体* 而不是 * 斜体 *
• 对于扩展语法，确保使用支持该语法的 Markdown 处理器

3. 使用场景

• 技术文档：使用行内代码标记代码片段，使用脚注添加技术说明
• 教程：使用粗体强调重点内容，使用高亮标记关键步骤
• 文档更新：使用删除线标记已修改的内容
• 学术文档：使用上标/下标表示引用或公式

11.3 个人实践总结

• 合理使用文本格式，增强文档的可读性
• 保持格式使用的一致性
• 注意标记符的正确使用，确保格式生效
• 在需要时使用转义字符处理特殊情况
• 根据文档类型和目标受众选择合适的文本格式