文档也是代码库的一部分Markdown 默认在富编辑器打开——斜杠菜单、工具栏、图片与代码内联预览、内部链接自动补全。想切回纯 Monaco 随时
Cmd+Shift+M。富 Markdown 编辑器
- 斜杠菜单：空行输入
/打开：标题、列表、代码块、callout、图片、mermaid 图表、toggle 块 /toggle-text可折叠笔记；/toggle-h1~/toggle-h5让 toggle 摘要显示为标题级别；保存为可移植的<details>/<summary>markdown- 内部链接：输入
[[开始 wiki 式链接，自动补全工作树内文件路径并插入相对链接 - 搜索尊重渲染文本：搜「Install」能找到写成
<h1>Install</h1>的标题 - 评审标注：富编辑器里选中渲染文本即可加标注（无需切回原始 markdown），快捷键
Cmd+Shift+A/Ctrl+Shift+A - Front matter：默认在富编辑器与预览中显示 YAML/TOML front matter；
⋯菜单可 Hide / Show（按文件记忆） - 表格：Tab 跳格、Enter 下移/加行、Backspace 删行；工具栏与右键菜单提供行列增删
- 目录（TOC）：长文档用编辑器头部的树形按钮打开标题大纲
内置查看器
| 格式 | 查看器 |
|---|---|
| Mermaid | Markdown 预览内联渲染；.mmd 独立文件有专用查看器（缩放/平移） |
| 滚动、缩放、文字选择；滚动位置跨切换恢复（仅会话内） | |
| 图片 | png/jpg/svg/webp/gif；图像 diff 模式并排比较两版 |
| CSV / TSV | 表格查看器：可排序列 + 快速搜索；工具栏切回原始文本 |
| Jupyter | .ipynb 渲染 markdown + 高亮代码单元 + 已保存输出；编辑写回磁盘并保持 nbformat（beta） |
Share as artifact（分享产物）
从编辑器头部 Share as artifact 可以把打开的 Markdown 文件发布为公开查看链接（需登录 Orca 账号并在 Settings → Artifacts 允许发布）。适合把评审文档、设计说明发给团队。
落地练习：写一篇文档
- 在工作树里新建一个
docs/demo.md - 用斜杠菜单插入标题、代码块、callout 与一个 mermaid 图表
- 用
[[链接到工作树里的另一个文件 - 写一张表格，练习 Tab / Enter / Backspace 的表格操作
- 打开 TOC，切一次 Cmd+Shift+M 看原始 markdown，再切回来
怎么判断做对了？——你能不看文档说出斜杠菜单、
[[链接、Cmd+Shift+M三者的作用，并亲手渲染出一个 mermaid 图。
卡住了怎么办？ 富编辑器渲染不对就切到原始 markdown 检查语法；mermaid 不显示确认代码块语言标为 mermaid。
小结
- 富 Markdown：斜杠菜单、
[[链接、渲染文本搜索、评审标注、front matter - 表格编辑键位与行列增删
- 内置查看器：Mermaid / PDF / 图片 diff / CSV / Jupyter
- Share as artifact 发布公开查看链接
下一节，文件管理器与外部拖放。