在 Vscode 中使用 Markdown 编辑文本时如何换行

VS Code Markdown 换行简明指南

前提设置：

• 确保 VS Code 中 "markdown preview enhanced" 插件已安装。
• 关键设置：在该插件设置中，取消勾选 "break on single new line" (默认是勾选的)。 这允许我们更精确地控制换行。

两种换行方式：

• 另起段落： 连续按两次回车键。 使上一个段落与下一个段落的间距更清晰。Markdown 会识别为新段落。 （编辑器行号会跳跃 +2）

• 句内换行： 空格键两次 + 回车键。 在 Markdown 中，这会在同一段落内换行，常用于长句排版，不产生新的段落。（例如在逗号后换行等等）

总结：

• 新段落: 双回车
• 句内换行: 空格空格 + 回车

这样设置和操作，你就能在 VS Code 中更灵活地控制 Markdown 文本的换行效果了。

在使用 Vscode 编辑 Markdown 文本时，换行有点特别，需要注意两种情况。

1. 首先要做一个设置 (重要！)

就像玩游戏前要先设置一下操作一样，在使用 Markdown 换行前，我们需要在 Vscode 里做一个小小的设置。

我们需要找到一个叫做 “markdown preview ofenhanced” 的 插件 (插件就像是给 Vscode 增加功能的工具)。在这个插件的设置里，找到 “break on single new line” 这一项，并且 取消勾选 (就是把前面的小勾勾去掉)。

💡 为什么要取消勾选？

默认情况下，Markdown 可能会把一个回车就当成换行。但我们取消这个勾选后，就能更精确地控制换行的方式，让它更符合我们的需要。

2. 使用回车键换行的两种方法

设置好之后，我们就可以开始用回车键来换行了。但是，根据你想达到的效果，回车的方式有两种：

2.1. 另起一段 (就像写作文换自然段) 使上一个段落与下一个段落的间距更清晰

如果你想 开始一个新的段落，就像写作文时换自然段一样，你需要 连续按两次回车键。

📝 操作步骤：

1. 写完一段文字。
2. 按一下回车键 （你会发现光标跳到下一行，但是行号只增加1）。
3. 再按一下回车键 （你会发现光标又跳到下一行，而且行号增加了2）。
4. 现在你就可以在新的一段开始写文字了。

简单记忆： 另起一段，回车两次！

2.2. 在同一句话内换行 (不是新起一行，只是为了让句子在编辑器里更好看)

有时候，我们写一句话很长，为了让句子在 Vscode 编辑器里看起来更整齐，方便自己阅读和修改，我们想在 一句话的中间换行，但又不想另起一段。 比如，在一句话的逗号后面换行。

这个时候，你需要这样做： 先按两次空格键，然后再按一下回车键。

📝 操作步骤：

1. 写一句话，写到你想换行的地方，比如逗号后面。
2. 按一下空格键 （光标会往后移动一个空格）。
3. 再按一下空格键 （光标再往后移动一个空格）。
4. 按一下回车键 （你会发现光标跳到下一行，但是这仍然是同一段话）。
5. 继续写这句话的剩余部分。

简单记忆： 句内换行，空格两次再回车！

总结一下：

• 想另起一段？ 连续回车两次。
• 想在句内换行？ 空格两次再回车。

当“markdown preview enhanced”插件中的“break on single new line”选项被启用（选中）时，与之前讨论的禁用（未选中）时相比，VS Code中Markdown换行符的差异。

如果 VS Code 中 "markdown preview enhanced" 插件 保持 默认设置，也就是 勾选 了 "break on single new line"，那么 Markdown 换行的操作就会变得更直接和符合我们日常的文本编辑习惯。

在这种情况下，换行操作的主要不同之处在于：

勾选 "break on single new line" 时的换行操作：

• 另起一行 (视觉上的换行): 按一次回车键 即可。 插件会直接将 单次回车 识别为 HTML 中的换行符 <br>，从而在预览中实现换行效果。 你会在编辑器中看到光标跳到下一行，预览效果也会直接换行。

  • 编辑器行号变化： 行号会 增加 1 (例如，行号从 4 变为 5)。

• 另起段落： 仍然需要 连续按两次回车键。 插件会将 两次或多次连续回车 识别为 新段落，用 <p> 标签 包裹，段落之间会有更明显的间距。

  • 编辑器行号变化： 行号会 跳跃增加 2 或更多 (例如，行号从 4 变为 6 或更高)。

• 句内换行 (空格键两次 + 回车): 在这种默认勾选的情况下， 不再需要使用 "空格键两次 + 回车" 来实现句内换行。 因为 单次回车已经被识别为换行，所以如果你想在句子内部换行，直接按 一次回车键 就可以了。 使用 "空格键两次 + 回车" 在这种模式下 可能不会产生预期的句内换行效果，或者效果与单次回车相同。

总结对比 (勾选 vs. 取消勾选 "break on single new line"):

换行目的	取消勾选 "break on single new line" (更精确控制)	勾选 "break on single new line" (默认，更直接)
另起一行 (视觉换行)	需要使用 "空格键两次 + 回车"	只需按一次回车键
另起段落	连续按两次回车键	仍然是 连续按两次回车键
操作复杂性	略微复杂，需要区分两种回车方式	更简单直接，更符合日常文本编辑习惯
Markdown 标准	更符合标准的 Markdown 语法 (单次回车在 HTML 中通常不换行)	略微偏离标准 Markdown 语法 (单次回车直接换行)

简单来说：

• 勾选 "break on single new line" (默认): 单次回车 = 换行， 双次回车 = 新段落。 操作更直观，接近普通文本编辑器的换行方式。
• 取消勾选 "break on single new line": 单次回车 (默认) 不换行， 双回车 = 新段落， 空格空格 + 回车 = 句内换行。 操作更精细，更符合 Markdown 标准，可以更精确地区分段落和句内换行。

选择哪种方式取决于你的偏好和需求：

• 如果你希望操作更简单直接，更符合日常习惯，并且对 Markdown 语法的细节不太在意， 那么 保持默认勾选 "break on single new line" 是可以的。
• 如果你希望更精确地控制 Markdown 的换行行为，更严格地遵循 Markdown 语法，并且需要区分句内换行和段落， 那么 取消勾选 "break on single new line" 会更适合你。

希望这个更详细的解释能够帮助你理解两种设置下 Markdown 换行的不同之处！

一些常用的、能有效提升 Markdown 文档可读性和结构的标签，并根据用途进行分类：

基础排版 & 文本样式:

• # 标题 (Headings): 用于设置文章标题和子标题，从 # 到 ###### 分别代表一级标题到六级标题。
  • 例如: # 一级标题 ## 二级标题 ### 三级标题
• ** 或 __ 加粗 (Bold): 用于强调文本，让文字看起来更醒目。
  • 例如: **这段文字会被加粗** 或 __这段文字也会加粗__
• * 或 _ 斜体 (Italic): 用于表示强调、书名、引言等，使文字倾斜。
  • 例如: *这段文字会倾斜* 或 _这段文字也会倾斜_
• ~~ 删除线 (Strikethrough): 用于表示删除或不再使用的内容。
  • 例如: ~~这段文字会被划上删除线~~
• ` 行内代码 (Inline Code): 用于标记代码片段或命令，通常使用等宽字体显示。
  • 例如: 使用 \printf()` 函数打印输出。`

列表:

• *, -, + 无序列表 (Unordered Lists): 用于创建项目符号列表，没有顺序关系。
  • 例如:Markdown
• 1., 2., 3. 有序列表 (Ordered Lists): 用于创建编号列表，有明确的顺序。
  • 例如:Markdown
• > 引用 (Blockquotes): 用于引用一段文字，通常会缩进显示。
  • 例如: > 这是一段引用的文字。

链接 & 图片:

• [链接文字](URL) 链接 (Links): 用于创建超链接，点击文字可以跳转到指定网址。
  • 例如: [访问 Google](https://www.google.com)
• ![图片描述](图片URL) 图片 (Images): 用于插入图片，图片描述 在图片无法显示时会作为替代文字。
  • 例如: ![示例图片](https://www.example.com/image.jpg)

分隔线 & 代码块:

• ---, ***, ___ 分隔线 (Horizontal Rules): 用于在内容之间创建水平分隔线，增强视觉分隔效果。
  • 例如: --- 或 *** 或 ___ (单独一行使用)
• ``` 代码块 (Fenced Code Blocks): 用于展示多行代码，可以指定代码语言进行语法高亮。
  • 例如: ```python def hello_world(): print("Hello, world!") ```

表格:

• |, - 表格 (Tables): 用于创建表格，用 | 分隔单元格，用 - 创建表头分隔线。
  • 例如:Markdown

高级一些的标签 (根据需求选择使用):

• > 嵌套引用 (Nested Blockquotes): 在引用中再使用 > 可以创建嵌套引用。
• 任务列表 (Task Lists): 一些 Markdown 编辑器支持任务列表，用 [ ] 和 [x] 表示未完成和已完成的任务。
  • 例如:Markdown
• 脚注 (Footnotes): 用于在文档末尾添加注释或参考文献。 (不同编辑器语法可能略有差异，常见如 [^脚注标记] 和 [^脚注标记]: 脚注内容)
• HTML 标签: Markdown 支持嵌入部分 HTML 标签，例如 <br> (换行), <span>, <div> 等，可以实现更复杂的样式或布局控制，但应谨慎使用，保持 Markdown 的简洁性。

推荐使用原则:

• 常用优先: 先掌握标题、加粗、斜体、列表、链接、图片这些最常用的标签。
• 按需学习: 根据你的写作需求，逐步学习代码块、表格、引用等更高级的标签。
• 简洁为主: Markdown 的优势在于简洁，避免过度使用标签，保持文档的清晰易读。
• 编辑器支持: 不同的 Markdown 编辑器可能对标签的支持程度略有差异，建议查阅你使用的编辑器的 Markdown 语法说明。