TUMBLINGCAT / 使用指南

TextPack 是什么文件?怎样打开、编辑和解压?

TextPack 把 Markdown 正文和本地图片保存在同一个文件中。收到 .textpack 或 .md.textpack 时,可以用滚猫 md 阅读和编辑,也可以用 ZIP 工具取出正文与附件。

更新于

与普通 .md 文件有什么区别?

普通 .md 文件保存文本,![图片](assets/photo.png) 这样的写法指向外部文件。TextPack 使用 ZIP 容器,包内包括 text.md、info.json 和 assets/ 图片附件,复制一个文件就能携带已内置的图片。

笔记.md.textpack 的最后一个扩展名仍是 .textpack。只把普通 Markdown 重命名为 .textpack 并不会完成转换,需要通过软件打包。

用滚猫打开与保存 TextPack

  1. 在 Windows 或 Android 版滚猫中点击“打开”,选择 .textpack 文件;Windows 也可以把文件拖入窗口。
  2. 切换到所见即所得、源码或阅读视图。粘贴截图或使用“插入本地图片”时,附件会进入文档包内。
  3. 点击“保存”写入更改。Android 从系统文件选择器导入文档后,第一次保存需要选择导出位置;恢复草稿不能代替保存文件。

没有支持 TextPack 的软件,怎样取出正文?

  1. 先复制一份文件作为备份。用支持 ZIP 的解压工具打开副本;如果工具不识别扩展名,可将副本的扩展名改为 .zip 再打开。
  2. 将整个包解压到同一个文件夹,保留 text.md 与 assets/ 的相对位置。
  3. 用普通 Markdown 编辑器打开 text.md。解压后的文件是独立副本,对它的修改不会自动写回原 TextPack。

能否完全离线使用?

正文与内置图片可以离线读取。已有网络图片链接在另存为 TextPack 时会保留原网址,并不会全部自动下载到包内。传文件前,先确认需要携带的图片确实已经内置。

可以先下载本页的样例:它包含双语正文和内置猫图标,不依赖外部图片网址。

支持的图片与容量边界

滚猫支持 PNG、JPEG、GIF 和 WebP 图片,每张最多 32 MiB。TextPack 压缩包和解压后的总大小分别最多 128 MiB,最多 4,096 个条目。

TextPack 不等于所有编辑器都能直接读写的通用文档格式;滚猫目前也不能直接打开 .textbundle 文件夹。与他人协作前,确认对方的软件支持方式。

功能与限制依据项目公开文档;本指南对应 Windows v0.5.1 / Android v0.5.2。 使用文档

READ. WRITE. TAKE IT WITH YOU.

Markdown 使用指南

查看全部使用指南