文件预览

了解知识库中各类文件的预览功能

文件预览

Knodo 知识库支持多种文件格式的在线预览。本文档介绍各类文件的预览功能和使用方法。

预览功能概述

在知识库中点击文件即可预览内容，无需下载：

• 支持多种文件格式
• 快速加载
• 响应式显示

Markdown 预览

基本功能

Markdown 文件（.md）支持实时渲染预览：

• 标题层级
• 列表（有序/无序）
• 代码块（语法高亮）
• 表格
• 链接和图片
• 引用块

示例效果

# 标题一

这是一段普通文本，**粗体** 和 *斜体*。

## 标题二

- 列表项 1
- 列表项 2

| 列1 | 列2 |
|-----|-----|
| A   | B   |

语法高亮

代码块支持多种编程语言的语法高亮：

```javascript
function hello() {
  console.log('Hello, World!');
}
```

支持的语言包括：JavaScript、TypeScript、Python、Java、Go、Rust、SQL、Bash 等 50+ 种语言。

数学公式

支持 LaTeX 数学公式：

行内公式：$E = mc^2$

块级公式：
$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + ... + x_n
$$

图片预览

支持格式

预览功能

• 自适应显示
• 点击放大
• 缩放和拖拽
• 显示图片信息

图片操作

在图片预览中：

• 滚轮：缩放
• 拖拽：移动
• 双击：适应窗口
• Esc：退出预览

PDF 预览

功能特点

• 分页显示
• 页面导航
• 缩放控制
• 全屏模式

操作方式

限制

• 大型 PDF 可能加载较慢
• 不支持 PDF 表单填写
• 不支持 PDF 编辑

Word 文档预览

支持格式

功能特点

• 在线预览文档内容
• 保留基本格式（标题、段落、列表等）
• 支持表格显示
• 支持图片显示

限制

• 仅支持 .docx 格式（不支持旧版 .doc）
• 不支持在线编辑
• 复杂格式可能显示略有差异
• 如需编辑请下载后使用本地 Office 软件

Excel 表格预览

支持格式

功能特点

• 在线预览表格内容
• 支持多工作表切换（.xlsx）
• 保留基本格式

限制

• 仅支持 .xlsx 格式（不支持旧版 .xls）
• 不支持在线编辑
• 复杂公式可能无法显示

XMind 思维导图预览

支持格式

功能特点

• 在线预览思维导图结构
• 支持节点展开/折叠
• 保留基本样式

视频预览

支持格式

功能特点

• 在线播放视频
• 支持播放控制（播放/暂停、进度、音量）
• 支持全屏播放

音频预览

支持格式

功能特点

• 在线播放音频
• 支持播放控制

代码文件预览

支持的语言

支持 50+ 种编程语言的语法高亮：

功能特点

• 语法高亮
• 行号显示
• 代码折叠
• 搜索定位

文本文件预览

支持格式

• .txt - 纯文本
• .log - 日志文件
• .ini, .conf, .cfg - 配置文件
• .xml - XML 文档
• .env - 环境变量文件

显示特点

• 等宽字体
• 行号显示
• 自动换行
• 搜索高亮

预览设置

主题设置

预览支持明暗主题：

• 跟随系统主题
• 手动切换

字体设置

代码预览的字体设置：

• 字体大小
• 字体族
• 行高

预览快捷键

不支持预览的文件

以下文件类型暂不支持在线预览：

对于不支持预览的文件，可以：

1. 点击下载到本地
2. 使用本地应用打开

预览性能

大文件处理

• 大于 1MB 的文本文件可能显示警告
• 大于 10MB 的文件不支持预览
• 建议拆分大型文件

加载优化

• 图片懒加载
• 代码块按需渲染
• PDF 分页加载

常见问题

Q：预览显示乱码怎么办？

A：检查文件编码，确保使用 UTF-8 编码。

Q：图片加载很慢怎么办？

A：检查网络连接，或压缩图片后重新上传。

Q：PDF 无法预览怎么办？

A：某些加密或特殊格式的 PDF 可能不支持预览，请下载后使用本地 PDF 阅读器。

Q：代码高亮不正确怎么办？

A：检查文件扩展名是否正确，系统根据扩展名判断语言类型。

相关文档

• 知识库管理
• 文件管理
• Markdown 编辑器