Appearance
第2章：Markdown 开发/编辑环境搭建
2.1 基础编辑工具准备
Markdown是纯文本格式，理论上可以使用任何文本编辑器来编辑。但为了获得更好的编辑体验，推荐使用专门的Markdown编辑器，它们通常提供实时预览功能，让你可以一边编辑一边看到最终效果。
通用工具
- 记事本：Windows系统自带，极简，无预览功能
- 备忘录：Mac系统自带，极简，无预览功能
- TextEdit：Mac系统自带，可切换到纯文本模式
新手推荐
- Typora：实时预览，语法提示，界面简洁，支持多平台（Windows/Mac/Linux）
- MarkText：开源免费，实时预览，功能丰富，支持多平台
- VS Code：配合Markdown插件使用，适合开发者
在线工具
- Markdown Editor：在线编辑，无需安装，直接使用
- StackEdit：功能丰富的在线Markdown编辑器，支持云存储
- Dillinger：在线Markdown编辑器，支持导出多种格式
笔记工具内置
- Obsidian：知识管理工具，原生支持Markdown
- Notion：全能笔记工具，支持Markdown语法
- 语雀：中文笔记工具，支持Markdown语法
- OneNote：微软笔记工具，部分支持Markdown语法
2.2 工具安装与基础操作
Typora 安装步骤
Windows系统
- 访问 Typora官网
- 点击「Download for Windows」
- 下载安装包后双击运行
- 按照安装向导完成安装
- 安装完成后，点击桌面图标启动Typora
Mac系统
- 访问 Typora官网
- 点击「Download for macOS」
- 下载.dmg文件后双击打开
- 将Typora拖拽到Applications文件夹
- 从Launchpad或Applications文件夹启动Typora
Linux系统
- 访问 Typora官网
- 点击「Download for Linux」
- 根据你的Linux发行版选择相应的安装包
- 按照官方说明完成安装
基础操作
创建文档
- 打开Typora
- 点击「文件」→「新建」或使用快捷键
Ctrl+N(Windows) /Command+N(Mac) - 一个新的Markdown文档就创建完成了
保存文档
- 点击「文件」→「保存」或使用快捷键
Ctrl+S(Windows) /Command+S(Mac) - 在弹出的对话框中选择保存位置
- 输入文件名，确保文件后缀为
.md - 点击「保存」按钮
实时预览开关
- Typora默认开启实时预览模式，编辑区和预览区是同一个区域
- 如需切换到源代码模式，点击「视图」→「源代码模式」或使用快捷键
Ctrl+/(Windows) /Command+/(Mac) - 再次使用相同快捷键可切换回实时预览模式
界面介绍
编辑区
- 主要的编辑区域，你可以在这里输入Markdown文本
- 在实时预览模式下，编辑区会实时显示渲染效果
- 在源代码模式下，编辑区显示原始的Markdown代码
预览区
- 在分屏模式下，右侧会显示预览区域
- 实时显示编辑内容的渲染效果
- 某些编辑器可能默认只显示编辑区，需要手动开启预览区
工具栏
- 位于编辑器顶部，提供常用的Markdown功能按钮
- 包括标题、文本样式、列表、链接、图片等功能
- 鼠标悬停在按钮上会显示相应的Markdown语法
2.3 环境验证
验证步骤
创建测试文档：打开你的Markdown编辑器，创建一个新文档
输入测试内容：在文档中输入以下内容：
markdown
# 环境验证测试
## 二级标题
### 三级标题
这是一段普通文本。
**这是加粗文本**
*这是斜体文本*
- 无序列表项1
- 无序列表项2
- 嵌套列表项
1. 有序列表项1
2. 有序列表项2
> 这是引用文本
---
[Markdown官网](https://daringfireball.net/projects/markdown/)
查看预览效果：确保所有元素都能正确渲染
- 标题层级正确显示
- 文本样式（加粗、斜体）正确显示
- 列表（有序、无序、嵌套）正确显示
- 引用和分割线正确显示
- 链接和图片正确显示
保存文档：将文档保存为
test.md，确保保存成功重新打开文档：关闭编辑器后重新打开文档，确保内容完整保留
验证标准
如果你的编辑器能够正确显示上述所有元素的渲染效果，并且能够成功保存和打开文档，那么你的Markdown环境已经搭建成功。
2.4 常用快捷键
通用快捷键
| 功能 | Windows/Linux | Mac |
|---|---|---|
| 新建文档 | Ctrl+N | Command+N |
| 打开文档 | Ctrl+O | Command+O |
| 保存文档 | Ctrl+S | Command+S |
| 复制 | Ctrl+C | Command+C |
| 粘贴 | Ctrl+V | Command+V |
| 剪切 | Ctrl+X | Command+X |
| 撤销 | Ctrl+Z | Command+Z |
| 重做 | Ctrl+Y | Command+Shift+Z |
| 查找 | Ctrl+F | Command+F |
| 替换 | Ctrl+H | Command+Option+F |
Markdown专用快捷键
| 功能 | Windows/Linux | Mac | Markdown语法 |
|---|---|---|---|
| 一级标题 | Ctrl+1 | Command+1 | # 标题 |
| 二级标题 | Ctrl+2 | Command+2 | ## 标题 |
| 三级标题 | Ctrl+3 | Command+3 | ### 标题 |
| 四级标题 | Ctrl+4 | Command+4 | #### 标题 |
| 五级标题 | Ctrl+5 | Command+5 | ##### 标题 |
| 六级标题 | Ctrl+6 | Command+6 | ###### 标题 |
| 加粗 | Ctrl+B | Command+B | 文本 |
| 斜体 | Ctrl+I | Command+I | 文本 |
| 无序列表 | Ctrl+U | Command+U | - 列表项 |
| 有序列表 | Ctrl+Shift+O | Command+Shift+O | 1. 列表项 |
| 引用 | Ctrl+Shift+Q | Command+Shift+Q | > 引用 |
| 代码块 | Ctrl+Shift+K | Command+Shift+K | 代码 |
| 行内代码 | Ctrl+Shift+` | Command+Shift+` | 代码 |
| 链接 | Ctrl+K | Command+K | 链接 |
| 图片 | Ctrl+Shift+I | Command+Shift+I | |
| 分割线 | Ctrl+Shift+- | Command+Shift+- | --- |
| 源代码模式 | Ctrl+/ | Command+/ | - |
2.5 常见环境问题排查
预览异常
问题：编辑内容在预览中不显示或显示异常
解决方案：
- 检查是否开启了实时预览模式
- 确认Markdown语法是否正确
- 尝试重启编辑器
- 更新编辑器到最新版本
格式错乱
问题：预览中的格式与预期不符
解决方案：
- 检查Markdown语法是否正确，特别是符号的使用
- 确认编辑器是否支持你使用的语法特性
- 尝试在不同的编辑器中打开文档，查看是否是编辑器兼容性问题
文档无法保存
问题：无法保存Markdown文档或保存后内容丢失
解决方案：
- 检查文件权限，确保你有写入权限
- 确认保存路径是否存在
- 尝试使用不同的文件名保存
- 检查磁盘空间是否充足
编辑器崩溃
问题：编辑器频繁崩溃或无响应
解决方案：
- 更新编辑器到最新版本
- 关闭不必要的插件或扩展
- 尝试清理编辑器缓存
- 如果问题持续，考虑更换其他编辑器
特殊字符显示问题
问题：文档中的特殊字符显示异常
解决方案：
- 确保文档使用UTF-8编码
- 尝试转义特殊字符，如使用
\转义 - 检查编辑器的字符编码设置
图片不显示
问题：文档中的图片无法显示
解决方案：
- 检查图片路径是否正确
- 确认网络图片链接是否可访问
- 检查本地图片是否存在
- 尝试使用绝对路径或相对路径
通过以上步骤，你应该能够成功搭建Markdown编辑环境，并解决常见的环境问题。如果遇到其他问题，可以查阅编辑器的官方文档或社区论坛寻求帮助。