前置知识: Markdown

编辑器功能

5 minBeginner2026/6/14

Markdown编辑器核心功能:实时预览、快捷键操作与高效编辑技巧。

1. 编辑器

1.1 编辑器分

代表特点
所见即所得Typora、Notion编辑即预览,无分屏
分屏预览VS Code、Obsidian左编辑右预览
纯文本Vim、Sublime Text无预览,专注编辑
在线编辑StackEdit、Dillinger浏览器中使用
平台内置GitHub、GitLab平台集成编辑器

1.2 选型建议

需求推荐理由
长文写作Typora所见即所得,沉浸式
技术文档VS Code插件丰富,Git 集成
知识管理Obsidian双链笔记、插件生态
快速编辑Vim / Nano服务器环境
协作编辑Notion / HackMD实时协作

2. 实时预览

2.1 预览模式

模式说明适用场景
并排预览编辑区和预览区并排对比查看效果
内联预览编辑区内直接渲染快速确认格式
全屏预览只显示渲染结果最终效果检查
所见即所得编辑即渲染长文写作

2.2 VS Code 预览

# 打开预览
Ctrl+Shift+V    # Windows/Linux
Cmd+Shift+V     # macOS

# 侧边预览
Ctrl+K V        # Windows/Linux(先按 Ctrl+K,松开后按 V)
Cmd+K V         # macOS

2.3 Obsidian 预览

Obsidian 支持三种编辑模式:

  • 实时预览:编辑时即时渲染 Markdown 语法
  • 源码模式:显示原始 Markdown 文本
  • 阅读模式:只读渲染视

3. 快捷键

3.1 通用快捷键

操作VS CodeTyporaObsidian
加粗Ctrl+BCtrl+BCtrl+B
斜体Ctrl+ICtrl+ICtrl+I
插入链接Ctrl+KCtrl+KCtrl+K
代码Ctrl+`Ctrl+`Ctrl+`
标题Ctrl+Shift+]Ctrl+1~6Ctrl+1~6
有序列表Ctrl+Shift+[
无序列表Ctrl+Shift+]
引用Ctrl+Shift+Q

3.2 VS Code Markdown 快捷键

操作快捷键说明
预览Ctrl+Shift+V打开预览标签
侧边预览Ctrl+K V并排预览
全屏预览预览中按 Ctrl+Shift+V切换全屏
目录预览中点击标题跳转到对应位置

3.3 Typora 快捷键

操作快捷键说明
源码模式Ctrl+/切换源码/渲染
专注模式F8高亮当前行
打字机模式F9当前行居中
大纲Ctrl+Shift+O显示文档大纲
插入表格Ctrl+T可视化创建表格
插入图片Ctrl+Shift+I插入
高亮Ctrl+Shift+H==高亮==

4. 高效编辑技巧

4.1 代码片段(Snippets)

VS Code 中可以自定义 Markdown 代码片段:

// .vscode/markdown.code-snippets
{
  "Markdown Table": {
    "prefix": "mdtable",
    "body": ["| ${1:列1} | ${2:列2} | ${3:列3} |", "| --- | --- | --- |", "| $0 |  |  |"],
    "description": "插入 Markdown 表格"
  },
  "Markdown Code Block": {
    "prefix": "mdcode",
    "body": ["```${1:language}", "$0", "```"],
    "description": "插入代码块"
  },
  "Markdown Note": {
    "prefix": "mdnote",
    "body": ["> **注意**: $0"],
    "description": "插入注意框"
  }
}

4.2 自动补全

触发补全内容说明
# + 空格标题ATX 标题
- + 空格无序列表列表项
1. + 空格有序列表编号列表
> + 空格引用引用
``` + 语言代码围栏代码块
--- + 回车分隔线水平线

4.3 粘贴

编辑器方式说明
Typora直接粘贴自动保存到指定目录
VS Code需插件Paste Image 插件
Obsidian直接粘贴自动保存到附件目录
GitHub拖拽上传自动上传到仓库

4.4 文件管理

# VS Code Markdown 相关插件
# - Markdown All in One: 快捷键、目录、预览
# - Markdown Preview Enhanced: 增强预览、Mermaid、数学公式
# - markdownlint: 语法检查
# - Paste Image: 粘贴图片
# - Markdown Table Formatter: 表格格式化

5. 语法检查

5.1 markdownlint

markdownlint 是 Markdown 代码质量工具,检查常见问题:

规则编号说明
标题层级MD001标题应按层级递进
首行标题MD041文件首行应为顶级标题
行长度MD013行长度限制(默认 80)
空格MD009行尾不应有尾随空格
代码块语言MD040代码围栏应指定语言
重复链接MD034应使用引用式链接

5.2 配置

// .markdownlint.json
{
  "MD013": {
    "line_length": 120
  },
  "MD033": false,
  "MD041": false
}