markdown文本格式 - colacat-mp3/wiki1 GitHub Wiki

#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 替代方案:

这是高亮文本

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

段落基本规则:

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

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

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

这是第三个段落。

常见错误:

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

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

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

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

第一行内容(这里有两个空格)
第二行内容 方法二:HTML 换行标签

第一行内容
第二行内容 方法三:反斜杠(部分解析器支持)

第一行内容
第二行内容 实际应用示例:

地址:北京市朝阳区
电话:010-12345678
邮箱:[email protected]

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

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

分隔段落:

第一段内容

第二段内容 分隔不同元素:

标题

段落内容

  • 列表项1
  • 列表项2

另一段内容 最佳实践建议:

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

内容来源:菜鸟教程

⚠️ **GitHub.com Fallback** ⚠️