现在位置: 首页 > Markdown 教程 > 正文

Markdown 文本格式

Markdown 段落没有特殊的格式,直接编写文字就好,段落的换行是使用两个以上空格加上回车

当然也可以在段落后面使用一个空行来表示重新开始一个段落。


字体

文本强调是写作中的重要技巧,Markdown 提供了简洁的方式来实现粗体和斜体效果。

Markdown 可以使用以下几种字体:粗体和斜体。

粗体语法:使用两个星号 ** 或两个下划线 __ 包围文字:

这是**粗体文字**使用星号
这是__粗体文字__使用下划线

斜体语法:使用一个星号 * 或一个下划线 _ 包围文字:

这是*斜体文字*使用星号
这是_斜体文字_使用下划线

粗斜体组合:使用三个星号 *** 或三个下划线 ___

*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

显示效果如下所示:

混合使用技巧:

这段文字包含**粗体**、*斜体*和***粗斜体***的组合效果。

渲染效果如下:

使用建议

  • 推荐使用星号 * 而不是下划线 _,因为星号在各种 Markdown 解析器中兼容性更好
  • 不要过度使用强调,重点突出才有效果
  • 在中英文混合时,建议在强调符号前后加空格以提高可读性

分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

***

* * *

*****

- - -

----------

显示效果如下所示:


删除线

如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线 ~~ 即可,实例如下:

RUNOOB.COM
GOOGLE.COM
~~BAIDU.COM~~

显示效果如下所示:


下划线

下划线可以通过 HTML 的 <u> 标签来实现:

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

显示效果如下所示:


脚注

脚注是对文本的补充说明。

Markdown 脚注的格式如下:

[^要注明的文本]

以下实例演示了脚注的用法:

创建脚注格式类似这样 [^RUNOOB]。

[^RUNOOB]: 菜鸟教程 -- 学的不仅是技术,更是梦想!!!

演示效果如下:


行内代码标记

行内代码用于在正文中标记代码片段、命令、变量名等:

基本语法
使用一个反引号 ` 包围代码:

使用 `git commit` 命令提交代码
变量 `userName` 存储用户名
在终端中输入 `npm install` 安装依赖

渲染效果:

包含反引号的代码:当代码本身包含反引号时,使用两个反引号包围。

要显示反引号,使用 `` `code` `` 这样的格式

渲染效果:

应用场景

  • 技术文档中的 API 名称、函数名
  • 配置文件中的参数名
  • 命令行指令
  • 键盘快捷键(如 Ctrl+C

文本高亮(扩展语法)

文本高亮不是标准 Markdown 语法,但许多扩展支持:

常见语法(部分平台支持):

这是==高亮文本==

HTML 替代方案

这是<mark>高亮文本</mark>


段落和换行

段落的创建方法

在 Markdown 中,段落是文本的基本单位,理解段落规则对于正确格式化文档至关重要。

段落基本规则

  • 段落由一个或多个连续的文本行组成
  • 段落之间由一个或多个空行分隔
  • 普通段落不应该用空格或制表符缩进

正确的段落写法

这是第一个段落。它可以包含多个句子,内容可以很长,会自动换行显示。

这是第二个段落。注意上面有一个空行分隔。

这是第三个段落。

常见错误

这是第一段
这是第二段(错误:没有空行分隔)

    这是缩进段落(错误:不应该缩进)

强制换行技巧

有时需要在不创建新段落的情况下换行,Markdown 提供了几种方法:

方法一:行尾两个空格
在行尾添加两个或更多空格,然后按回车:

第一行内容(这里有两个空格)  
第二行内容

方法二:HTML 换行标签

第一行内容<br>
第二行内容

方法三:反斜杠(部分解析器支持)

第一行内容\
第二行内容

实际应用示例

地址:北京市朝阳区  
电话:010-12345678  
邮箱:admin@runoob.com

诗歌示例:
床前明月光,  
疑是地上霜。  
举头望明月,  
低头思故乡。

空行的作用

空行在 Markdown 中扮演重要角色:

分隔段落

第一段内容

第二段内容

分隔不同元素

# 标题

段落内容

- 列表项1
- 列表项2

另一段内容

最佳实践建议

  • 在标题和内容之间留空行
  • 在列表前后留空行
  • 在代码块前后留空行
  • 保持一致的空行使用习惯