# CherryTree Import Move an unencrypted CherryTree XML document into an Obsidian vault. Preview the node tree, then make Markdown notes with folders, links, tables, code, and embedded PNG images. The basic import is free and runs locally. Pro adds source properties, parent index notes, and subtree selection through GitHub Sponsors. The input must be a `.ctd` file. A SQLite `.ctb` document needs an XML export from CherryTree first. Keep the original document as your source copy while you check the imported notes. Preview a CherryTree document and open its imported notes. ## Quick start 1. To test the import, save this text as `test.ctd` with a text editor. It is a small CherryTree XML document with two nodes: ```xml See the plan Step one. ``` 2. In Obsidian, run the command "Import CherryTree XML". Select `test.ctd`. The dialog shows the node tree. 3. Keep the destination folder `CherryTree import`. Select "Import notes". 4. Open `CherryTree import/Projects.md`. Its text "the plan" links to `Projects/Plan.md`. ## Features ### Preview the node tree Select a local `.ctd` file with the import command. The dialog shows node names in tree order and counts the notes and PNG files. Read the warnings before you import. The preview can report a missing node link, an invalid image, or an attachment type that is not supported. Selecting a file prepares the preview; the Import notes button starts the vault writes. Seven nodes in the import preview. ### Notes in nested folders Each node becomes a note. A parent also gives its name to a folder for its children. In the sample, `aaa.md` is the parent note and `aaa/bbb.md` is its child. Safe Cyrillic names keep their letters. Forbidden filename characters become dashes, and duplicate sibling names get a number. Shared source nodes become separate notes with the shared text. An imported child note with a table. ### Rich text, code boxes and tables Bold, italic, and strikethrough use Markdown markers. Underline uses an HTML `u` element because Markdown has no underline marker. Heading scales from h1 to h6 become headings. Code boxes become fenced blocks with a language label. The last row of a CherryTree table becomes the header, followed by its data rows. Colors, fonts, and alignment are not reproduced. Headings, inline styles and shell code after conversion. ### Node, web and local file links Node links use wikilinks with the imported target path and source label. Web links use Markdown links. Base64 file and folder paths become `file:` links; the plugin does not read those targets. A link to a missing or excluded node keeps its label and gives a warning. Web addresses must use HTTP or HTTPS to become links. CherryTree anchors are not kept. A link to an anchor opens the note that held the anchor, and the preview gives a warning. An imported note with a node link and web link. ### Embedded PNG images PNG objects become files in the destination's `attachments` folder. The note embeds those files at the source character positions. Image names contain a node id and an object number, so equal labels do not share an attachment path. PNG data with a bad signature gives a warning. LaTeX source is kept as a code block; other embedded attachment types are reported and are not saved. Four imported PNG embeds in one note. ### Tags and creation dates (Pro) With this option enabled, node tags become frontmatter tags and a valid creation timestamp becomes a `created` property in UTC. Nodes without those values get no empty property block. The note body uses the same conversion as the free import. Source tags and creation date in an imported note. ### Parent index notes (Pro) Add an `_index.md` note inside each imported parent folder. Its links point to the immediate child notes. The original parent note remains in the import, so its source text has its own place. A node without children does not get an index. An index note links to the child notes. ### Selected subtree (Pro) Choose a node in the dialog to import that node and its descendants. The folder paths keep the source ancestors, even when those ancestor notes are excluded. The preview counts change to match the selection. Use Whole document to return to the complete tree. A selected branch in the import preview. ## Install For a manual install, copy `main.js`, `manifest.json`, and `styles.css` from the supplied build into `.obsidian/plugins/cherrytree-import/` in your vault. Reload Obsidian and enable CherryTree Import under Community plugins. The minimum supported public app release is 1.13.4. This repository does not claim that a community listing is live. ## Usage Export the document from CherryTree as XML without a password. In Obsidian, run CherryTree Import: Import CherryTree XML from the command palette. Select the export, enter a new destination folder, and check the tree and warnings. Enable the Pro options if your account has Pro. Select Import notes, then open the result from the file explorer. The destination must not exist. This rule prevents an import from merging into your existing notes. For another attempt, use a new folder name. If a write fails, the result can be partial. Check that folder before you retry. The source file is read and is not changed. The file picker can read an export from outside the vault to give the converter its XML input. ## Settings After a minor or major update, this plugin opens one What's new tab in the background. The tab and settings card suggest other NoteMods plugins and Zovo Chat and link to notemods.com for feedback ([privacy](https://notemods.com/privacy/)). The tab sends no data. Turn the tab off in Settings. The Destination folder setting supplies the next dialog's default path. The dialog has separate controls for properties, parent indexes, and subtree selection. If Pro is off and you select one of these controls, a notice tells you how to get Pro, with a Sponsor on GitHub button. The option stays off. Sign in, refresh the sponsorship status, or sign out in the plugin's Pro section. A saved import option does not bypass the sponsorship check. ## FAQ Disabling the plugin stops new import writes. A folder, image or note write already in progress can finish. Completed output stays in the destination. The stopped import reports its completed notes, PNG images and folders. Check that output, then retry with a new folder name. Why does a `.ctb` file fail? It is a SQLite document. Export to `.ctd` with no password first. Encrypted files are outside the supported input format. What limits apply? File selection allows up to 25 MB. The planner limits documents to 10,000 nodes and 100 tree levels. Documents with duplicate or missing ids, XML document types, or empty node trees are refused. What was not tested? Physical Android and iOS devices, encrypted exports, very large production archives, and a live paid GitHub sign-in were not tested. Automated Pro checks use a fake token and a local reply. Windows and Linux app runs were not performed locally. Bookmarks, icons, search flags, font sizes, and color layouts are outside the conversion scope. ## Payment, account and network The core features are free. Pro features need a GitHub Sponsors sponsorship of theluckystrike: $5 a month or more, or $15 once. A total payment of $15 meets the payment requirement for Pro without further payment. Sign-in and the checks below still apply. Your notes stay readable and editable with or without Pro. GitHub handles the payment. Sponsor at https://github.com/sponsors/theluckystrike?frequency=one-time&metadata_source=cherrytree-import. You need no account for the free features. Pro needs the GitHub account that sponsors. Until you select "Sign in with GitHub" in the settings, CherryTree Import makes no network requests. Sign in uses the GitHub device flow. CherryTree Import sends its public client ID and the scope `read:user` to `https://github.com/login/device/code` and shows you a code. While you enter the code at https://github.com/login/device, it asks `https://github.com/login/oauth/access_token` every few seconds to check the sign-in status. The scope permits profile reads only. GitHub needs this access to show the sponsorship tier. It grants no repository scope and no write access. After sign in, CherryTree Import sends one query to `https://api.github.com/graphql`. It checks if the signed-in account sponsors theluckystrike. It asks for the tier and the total payment to theluckystrike. The plugin reuses a successful check for 7 days. Failed checks can retry after 6 hours. Select Refresh to request an earlier check. It sends no note content, file names or other vault data, and it has no telemetry. After a successful check, Pro can work offline for up to 14 days. Sign out or a negative sponsorship answer turns Pro off. The plugin stores the GitHub token through the secret storage API of Obsidian. It does not put the token in its saved settings or its local sponsorship data. The local storage of this device keeps your GitHub login, the tier and the time of the last check. Sign out clears the token. You can also revoke the access in your GitHub settings, under Applications. ## Support For help, contact theluckystrike through the product's GitHub page or notemods.com. Give the plugin version, app version, warning text, and a small example that you can share. Remove private note content from that example. This project uses the MIT license. The test folder records the public CherryTree sample sources and the changes made for the local fixture. ## Community Questions, bugs or plugin ideas? Talk to me and other Obsidian users in [Zovo Chat](https://t.me/+k2MM-BIc7SQ5OWM0) on Telegram. It has a topic for these plugins. You can also open an issue here.