Skip to main content

Convert FreePlane Mind Map to Markdown for import into Roam

Project description

Mind Map to Markdown for Roam import

Got a Mind Map with contents you'd like to import into Roam?

This Python application might do what just you want.

It will take a Freeplane .mm Mind Map file and convert it into Markdown ready for manual import into Roam.

I think Freemind mind maps should also work, but I have not yet tested them.

It's currently in early beta.


The generated markdown file will have a hierarchy of bullet points that match the branches of the Mind Map.

For each branch that has a description, the text of the description will be appended to the branch title, starting on the line below.

If a branch has a link to a web page a link will be generated in the markdown file.

Rich text is supported in branch titles and descriptions.


You need Python >= 3.8 and a recent version of pip3.


pip3 install fp2md4roam


From a command line, run convert_map <path_to_mind_map> <target_directory>

So, if you have a mind map file, and type convert_map foo with a root node called My Smart Mind Map this will create a file called in the output directory foo.

You can then import the into Roam in the usual way.

When Roam imports a Markdown file it will ask you what name you want for the page after import.

Since this application will remove spaces and punctuation for the generated file name you may want to alter the page name before you import it.


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fp2md4roam-0.2.2.tar.gz (4.4 kB view hashes)

Uploaded source

Built Distribution

fp2md4roam-0.2.2-py3-none-any.whl (5.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page