文件预览与 Live Markdown
右侧工作区直接渲染代码、Markdown、图片、PDF、Office 与音视频;Markdown 就是编辑器,停止输入 1.5 秒自动写盘。
更新于 2026年11月10日
预览只占右侧工作区的一个标签,标题就是文件名。文件列表、改动列表、对话里的路径 chip、工具结果和交付物卡都从这里打开;同一个文件再次打开只聚焦已有标签,不重复开。
支持的文件类型
- 代码与文本:带语法高亮,配色跟随深浅主题。文件过大时改用纯文本并只展示开头部分。空文件显示「(文件为空)」。
- Markdown:直接以可编辑的 Live Markdown 呈现,代码块、表格、Mermaid、公式、图片都按渲染结果显示。
- HTML:默认渲染页面,工具栏按钮在「切换到源码预览」「切换到渲染预览」之间切换。
- 图片:
.png .jpg .jpeg .gif .webp .svg .bmp .ico。 - 视频:
.mp4 .m4v .mov .webm .ogv。音频:.mp3 .m4a .aac .wav .ogg .oga .opus .flac。 - PDF:原文件渲染,不抽文本。
- Office:
.docx .xlsx .pptx走高保真预览;高保真失败降级为自渲染 HTML,再失败降级为纯文本。 - 其他类型,或内容不适合内联时,显示「无法安全内联预览」的卡片,列出文件、类型、大小、修改时间,并给打开按钮。磁盘镜像、安装包、压缩包这类既没有渲染器、字节又永远不是文本的容器也走这张卡,不会被当文本读进来。
工具条
从左到右:文件名(悬停看完整路径)、用默认应用打开、在文件夹中显示、复制文件内容、刷新文件内容、换行开关。
- 复制按钮把文件内容写进剪贴板。
- 换行开关按状态显示「当前为自动换行,点击改为横向滚动」或反之,默认自动换行并记住选择。
- 刷新按钮的说明是「刷新文件内容(检测外部编辑器的修改)」。
查找
Cmd/Ctrl + F 在预览里打开查找栏,输入框占位「查找」。
- 三个开关:
Aa区分大小写、ab全词匹配、.*正则。 - 状态依次显示「1/8」「无结果」「表达式无效」。
Enter下一个、Shift + Enter上一个,Esc关闭。- PDF 显示「暂不支持 PDF 搜索」,音视频显示「暂不支持媒体搜索」。
Markdown 目录
正文够宽时,左侧常驻一列「目录」,按标题层级列出,空文档显示「暂无标题」。
- 正文变窄后目录收成左侧窄轨,展开时浮在正文上,点空白处收起。
- 收起按钮是「收起目录」,折叠后的展开按钮提示「展开目录」。
- 目录展开状态只在本次运行记住,重启后默认展开。
缩放
PDF 和图片顶部有 − / 百分比 / 「适应宽度」 / + 的工具条。
- 缩放范围 10%–500%,图片可用双指或滚轮缩放,放大后按住拖动平移。
- 「适应宽度」让内容适应容器宽度,但不会放大到超过原始尺寸。
Live Markdown
Markdown 预览本身就是编辑器:打开即可改,停止输入片刻后自动写回磁盘,不需要手动保存。
- 选中但还没落盘的修改会立即触发写盘,写盘不会退出编辑。
- 表格是单元格级别的编辑:提示「点击编辑、右键操作更多」,编辑时
Enter保存、Shift + Enter换行、Tab切单元格、Esc取消;右键可插入或删除行列、删除整张表格,列数不足三列时「删除本列」禁用。 - 链接默认点击跳转,
Alt/Option + 点击改成编辑链接源码,方便改正写错的地址。 - 普通
.txt、.log等纯文本需要点「编辑文本」才能改,Markdown 不需要。
注意
- 文本超过 5MB 拒绝内联:「此文本文件超过 5 MB,无法安全进行内联预览,请使用默认应用打开。」;判定为二进制或编码异常时提示「此二进制或编码异常文件暂不支持内联预览,请使用默认应用打开。」
- 单个文件渲染上限 50MB,PDF 与 Office 超限即视为预览失败;
.doc .xls .ppt这类旧格式不支持内联,会提示转换格式。 - Office 预览有截断:最多前 8 个工作表、每表 200 行、每行 40 列、前 80 页幻灯片,超出部分在预览里明确标注。
- 外部编辑器改了正在看的文件,不会弹窗确认,窗口重新获得焦点时静默刷新到最新内容。
- 文件被移走或删除时,正文通常显示「(文件为空)」而不是「文件不存在」,图片和 PDF 才会以「文件过大」之类的方式暴露读取失败。
- 从文件列表、改动列表打开的预览可以读会话目录之外的文件;从对话里的引用打开的预览不改变原文件权限。