Exporting and Importing the Tag Tree

Tagboat Pro can export your tag tree to a Markdown file, and import from Markdown into Tagboat. This offers a way to back up your tag tree, edit it using other apps, or import a tag tree that you’ve built elsewhere.

Tagboat’s tag tree is represented in Markdown as a bulleted list, with each child tag indented one level from its parent. If a tag has a hotkey assigned, the hotkey’s letter or digit appears at the end of the line, after a comma:

- Architecture
- Art
- Aviation,v
    - Aerobatics
    - Aircraft,a
        - 747
        - A-12
        - B-17
        - B-29
        - B-36
        - Blackbird,b

Choose "Export..." from the "Tags“ menu to export your tag tree to a Markdown file. This will produce a text file with similar structure to the list above.

Choose "Import…" from the "Tags“ menu to import tags from a Markdown file. This looks for the first unordered (bulleted) list in the input file, and tries to interpret its items as tag descriptions. The imported tags are combined with your existing tags as shown in Tagboat’s “Tags” window. If an existing tag has a different parent in the file you’re importing from, importing will move it to that new parent. Take care not to have duplicate items in the file you import from. Each tag must have a unique name.

The exported tag list is well-suited to diffing and version-tracking using tools such as git, if you’d like to maintain a backup and history of your tag tree.