How do I import from Notion?
How do I import from Roam?
How do I import from Logseq?
Can I import markdown files?
How do I import a TIF2 file?
Can I import a copy of another Tana Outliner workspace?
What does TIF2 import preserve?
Can I export my Tana Outliner data?
Yes, you can export your data as a Markdown or JSON file. Go to your workspace home node and click the ellipsis menu to the right.
Read more about workspace export or options for copy-paste and downloading nodes.
How can I download images and attachments with my Markdown export?
The Markdown ZIP does not contain media files. Images and videos usually appear as links in the Markdown, which you can open to save an individual file. Some other attachments may have no link in the Markdown; save those from Tana Outliner.
To save Tana-hosted media in bulk and make the Markdown links point to local copies:
- Export your workspace as Markdown and unzip the archive.
- Download the media helper and save it outside the unzipped folder.
- Run
python3 localize-tana-media.py "/path/to/unzipped-folder"in a terminal. On Windows, usepyinstead ofpython3.
The helper streams each reachable Tana-hosted file linked in the Markdown into an _media folder and updates those links. It only follows links to Tana’s Google Storage hosts. Links to other sites, and any links that fail to download, remain unchanged. Keep the original ZIP as a backup; the helper edits the extracted Markdown files.
How can I share a scrambled workspace with Tana support?
If Tana support asks for a workspace copy to investigate a problem, you can scramble a JSON export locally. The helper replaces node text, code, AI message text and editor email addresses, while keeping the nodes and their relationships for debugging. Links in node text, including attachment links, become placeholders.
- Export your workspace as JSON. If the filename ends in
.tif.json, ask support for a workspace snapshot JSON file. - Download the workspace scrambler.
- Open a terminal in the folder where you saved it. Use Python 3.9 or later. On Windows, use
pyinstead ofpython3and runpy -m pip install tzdatafirst to install timezone data. - Run
python3 -I scramble_tana.py "/path/to/workspace.json" "workspace-scrambled.json". - Run
python3 -I scramble_tana.py --verify "/path/to/workspace.json" "workspace-scrambled.json". You can add sensitive words or phrases after the file paths to check for remaining matches. If either command fails, contact support before sharing the file.
Review the scrambled copy before sending it through the support channel that requested it. Word lengths, digit counts and repeated words remain visible. Node IDs, timestamps, calendar dates and other metadata remain. A passing verification check does not guarantee anonymity. Searches and custom commands that depend on exact text or numbers may behave differently after scrambling.
Can I get my data in and out?
Yes. Currently we support Roam, OPML/Workflowy, and Logseq as native import formats. Export as Markdown or JSON, or check out Tana Outliner Publish, whenever you need to move things elsewhere. Your data stays yours.
What are all the ways I can copy data out of Tana Outliner?
Basic copy-paste. Copy-pasting content is the fastest way of getting data out of the app. Select the content you want to copy, then hit Cmd/Ctrl+C. To paste, Cmd/Ctrl+V either in Tana Outliner (will create references) or elsewhere.
More copy-paste options. Via the command line (Cmd/Ctrl+K) there are various flavors of copy available to you. Read about all copy-paste options in copy-paste and export.
Other ways to get content out:
- Download nodes. You can download a selection of nodes (for example, all tagged items or results in a search node) in markdown or Tana Outliner Paste with the
Download ascommand in theCtrl/Cmd+Kmenu. - Export plain HTML. Renders an HTML page of the selected content that you can copy the HTML of, or save as an HTML file.
- Export workspace as markdown or JSON. To learn more about this, read about workspace export.
How to use Tana Outliner Paste with supertags that have non-alphanumeric characters?
Tana Outliner Paste can usually parse supertags that are one word, such as #task. If a supertag has spaces, numbers, or irregular characters, try wrapping the name in double brackets like this:
#[[1'3$4'6]]
If you want to grab the supertag definition, include the hashtag within the brackets, like this:
[[#1'3$4'6]]
How do I enable the scan text feature in Tana Outliner Capture on iOS?
The iOS feature Live Text needs to be turned on for all supported languages:
- Go to iOS Settings > General > Language and Region.
- Turn on Live Text (green is on).
This feature is available with iOS 15.4 or later.

