semvec/pypi-packages huggingface dataset:
fp2md4roam 0.2.2
Convert FreePlane Mind Map to Markdown for import into Roam
Requires Python: >=3.8

# 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. 

## Features

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.

## Requirements

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

## Installation

`pip3 install fp2md4roam`

## Use

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

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

You can then import the `MySmartMap.md` 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.

### Example:
errui 0.1.0
Error handling for end users
Requires Python: >=3.9,<4.0

# ErrUI

Open a window when an exception is raised and prompt the end user to decide what to do.


## Installation

```sh
python -m pip install errui
```

## Example

### `AbortWindow` (Optional suppression)

This is like `contextlib.suppress` except you get to choose whether to suppress it or to let the exception through and still be raised.

```py
from errui import AbortWindow

with AbortWindow(KeyError):
    {}[0]
```