打开方式

每个文件，用最合适的方式打开。

udctl 用最合适的查看器显示每个文件——图片用图片查看器，图表用图表编辑器。你可以随时切换查看器、设置自己的默认项，或用插件教会 udctl 一种全新的文件类型。

7+ 内置查看器1-click 插件安装已上线 网页版

合适的查看器

合适的视图，随你更改。

一键切换查看器

大多数时候 udctl 会根据文件名自动选好查看器。当一个文件可以用多种方式显示时，文件上方的 打开方式 按钮会显示当前使用的查看器，并让你切换到另一个——此外还随时提供“以文本查看”和“下载”。当同一类文件有不止一个插件能打开时，它们都会各自作为一个选项出现在菜单里。

设置跟随你的默认项

想让某种文件总是用同样方式打开？选择“始终以此方式打开 .xyz 文件”。默认项绑定到你的账号，会跨设备跟随你，也不会影响任何其他人。

文档：切换与默认项 →

内置

覆盖你最常用的文件类型。

图表

.drawio 通用图表与 udctl 数据流图

Excalidraw

手绘风格草图

图片、视频与音频

内嵌预览媒体文件

PDF 与 Word

文档就地打开

电子表格与表格

行列直接渲染

Markdown、代码与文本

内置语法高亮

演示文稿与 HTML

幻灯片与网页

其他类型？ 任何没有内置查看器的文件类型都无法自行预览——udctl 不会给你一个空白预览，而是告诉你还没有能打开它的应用，并在下载链接旁边把你指向插件库，让你为它添加一个查看器。

你自己的查看器

教会 udctl 一种新文件类型。

一个插件就是一个自包含的 .html 文件——就像安装一个 app 让操作系统能打开一种新文件。udctl 把要显示的文件交给插件，插件负责绘制。一个完整可用的插件就这么简单：

viewer.html

<!doctype html>
<html>
  <body>
    <pre id="out">Waiting for a file…</pre>
    <script>
      // 1. Listen for the file udctl will send.
      window.addEventListener('message', function (event) {
        var msg = event.data;
        if (!msg || msg.udPlugin !== 1 || msg.type !== 'file') return;
        var text = new TextDecoder().decode(msg.bytes);
        document.getElementById('out').textContent =
          msg.fileName + '\n\n' + text;
      });
      // 2. Tell udctl we are ready to receive it.
      parent.postMessage({ udPlugin: 1, type: 'ready' }, '*');
    </script>
  </body>
</html>