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 另一段内容
最佳实践建议:
- 在标题和内容之间留空行
- 在列表前后留空行
- 在代码块前后留空行
- 保持一致的空行使用习惯