用 Markdown 写作与编辑

先用标题组织内容

一篇笔记可以先写结论或背景，再用二级标题划分主题。三级标题适合拆分较长的小节，避免仅用加粗文字模拟所有层级。

Markune 的可视化编辑与源码模式围绕同一份 Markdown 正文工作。先把内容写完整，再整理标题，比先调整大量外观设置更容易形成清晰结构。

# 一次技术调研

这里用两句话说明问题和结论。

## 背景

需要解决什么问题？

## 可选方案

### 方案一

说明适用场景与限制。

## 下一步

- [ ] 验证一个最小示例

使用列表、表格与代码块

在可视化编辑中输入 Markdown，或在新段落使用斜杠命令选择所需内容。任务列表适合记录待办；引用块用来区分引用内容；代码块用于保留缩进与代码文本。

表格适合比较少量并列信息。列太多会降低可读性，可以拆成多个小表，或把长解释放回正文。

- 普通列表项
- [ ] 尚未完成
- [x] 已经完成

> 这是一段引用。

| 事项 | 状态 |
| --- | --- |
| 阅读文档 | 已完成 |
| 运行示例 | 待处理 |

```java
System.out.println("Hello, Markune");
```

切换到源码模式检查原文

1. 1

   先把焦点放进编辑器

   点击正文编辑区，再使用 macOS 的 ⌘ / 或 Windows 的 Ctrl /。该快捷键切换当前文档的可视化编辑与源码模式。

2. 2

   只修改你理解的部分

   源码模式适合检查链接、列表缩进或粘贴内容。修改后再切回可视化编辑，确认结构和显示符合预期。

3. 3

   等待保存完成

   两个模式操作的是同一篇文档。切换模式不是另存副本，修改前需要备份的内容仍应先备份。

区分当前文档查找与全局搜索

查找与替换针对当前编辑器中的内容。想找另一篇笔记，应使用工作区的搜索入口；执行替换前先确认匹配内容，避免一次改动太多位置。

插入附件，保留完整引用

使用编辑器提供的附件插入入口添加本地文件。Markune 0.2.4 的内置资源会写入当前工作区，并在文档中保留可解析的资源引用。不要把展示时的临时图片地址当成需要保存的正文。

来自网络的图片依赖对应资源地址，显示或访问时可能联网。要把文档交给工作区之外的人，优先使用导出功能并检查资源是否一并带出。

大文档加载失败时如何继续

0.2.4 会在大文档解析与分步渲染时显示进度。等待结构准备完成后再编辑，不要因为短暂加载就反复关闭和重开文件。

若显示加载失败，先尝试“重新加载”；也可以使用“使用源码模式”入口继续查看或编辑。报错不代表磁盘正文已经被删除，先确认原文件并备份，再定位具体内容。