# TextPack Import/Export

Portable file formats are essential for avoiding vendor lock-in. Marked Share embraces the open [TextBundle](http://textbundle.org/) and TextPack standards to keep your content self-contained and universally readable.

## What is a TextPack?

A **TextBundle** is an open format that groups Markdown text and all associated assets into a single bundle folder. A **TextPack** is simply a compressed (zipped) TextBundle file with a `.textpack` extension.

Inside a Marked Share TextPack archive, you will find:

- `text.md` (or `text.markdown`): The complete, raw Markdown source.
- `assets/`: Embedded images referenced throughout the text (PNGs, JPEGs, GIFs, WebPs).
- `info.json`: Metadata specifying the Markdown dialect and published reading style preferences.
- `highlights.json`: Any highlights, notes, and signatures attached to the document.

## Importing Documents

You can import documents into your Marked Share library at any time:

- **Drag and Drop:** Drag a `.textpack`, `.zip`, or `.md` file directly into your Library or upload area.
- **Capture Web Pages:** Use the **Capture URL** tool to convert an external web article into clean Markdown and assets automatically.
- **Asset Handling:** Local image paths are automatically parsed, uploaded to secure cloud storage, and updated to point to resilient hosted URLs.

## Exporting and Round-Tripping

Every document published on Marked Share can be exported immediately:

- Click the **TextBundle** link in the document toolbar or share dialog.
- Download raw Markdown via `/d/<id>.md`.
- Download the complete asset-backed archive via `/d/<id>.textpack`.

Because Marked Share exports follow the standard TextBundle specification, you can open exported TextPacks in Marked, Ulysses, Bear, or any compatible editor with all images and reading styles completely intact.
