TUMBLINGCAT / GUIDE

What is a TextPack file, and how do you open it?

TextPack stores Markdown and local images in one file. Open .textpack or .md.textpack documents in TumblingCat, or use a ZIP utility to extract the text and attachments.

Updated

How does it differ from a .md file?

A regular .md file contains text, with image links such as ![Photo](assets/photo.png) pointing to separate files. TextPack is a ZIP container containing text.md, info.json, and images in assets/. Embedded images travel with the package.

The final extension of notes.md.textpack is still .textpack. Renaming an ordinary Markdown file does not convert it; use an application to create the package.

Open, edit, and save in TumblingCat

  1. Use Open in TumblingCat for Windows or Android and select the .textpack file. On Windows, you can also drag it into the app.
  2. Switch between WYSIWYG, Source, and Reader. Pasted screenshots and inserted local images become attachments inside the document.
  3. Select Save to write your changes. On Android, the first save after importing through the system picker asks for an export destination. Recovery drafts do not replace saving the file.

Extract the content for another editor

  1. Make a backup copy. Open the copy with a ZIP utility; if the utility does not recognize the extension, rename the copy to .zip.
  2. Extract the entire package into one folder, preserving the relative positions of text.md and assets/.
  3. Open text.md with a Markdown editor. Changes to the extracted copy do not automatically update the original TextPack file.

Does it work offline?

The text and embedded images work offline. Existing remote image links keep their original URLs when you save as TextPack, so those images still depend on the network. Check that required images are embedded before sharing.

The downloadable sample contains bilingual text and an embedded cat icon. Its image does not require an external image server.

Image support and limits

TumblingCat supports PNG, JPEG, GIF, and WebP images, up to 32 MiB each. Compressed and uncompressed package totals are each limited to 128 MiB, with up to 4,096 entries.

Not every Markdown editor directly supports TextPack. TumblingCat also does not directly open .textbundle folders. Check your collaborator’s software before sharing editable packages.

Based on the project documentation for Windows v0.5.1 / Android v0.5.2. Documentation

READ. WRITE. TAKE IT WITH YOU.

Markdown guides

How to share Markdown with its images in one file

A Markdown note can lose its pictures when you copy only the .md file. TumblingCat can bundle Markdown and accessible local images into a single TextPack document.

Open, edit, and read Markdown on Windows

TumblingCat is a free, open-source Markdown reader and editor with a portable Windows EXE. Switch between formatted editing, source, and reading views without creating an account.

Read Markdown and illustrated notes on Android

TumblingCat for Android opens local Markdown and TextPack notes with embedded images. The current APK supports ARM64 devices running Android 7.0 or later.

Markdown images not showing? Check paths, permissions, and URLs

Opening the Markdown text does not guarantee that an app can access its images. First identify local files versus remote URLs, then check paths, permissions, and formats.

Export Markdown to PNG images or copy a selected passage

TumblingCat can export a complete Markdown document to PNG images or copy selected text as an image. Long documents are split into numbered pages, so you do not have to capture each screen manually.

Browse all guides