Task guide

Round-trip a portable model

Import Markdown, export JSON, and inspect the same nodes and flows.

Before you start

Prerequisites: A browser and a backup of existing work.
Permissions and plan: Local import/export needs no account.

Steps

Copy the example below and import it through the editor's Import control.
Choose Export and select JSON. Save the file.
Inspect the file for the api and db node IDs and the requests flow.
Import that exported file. It becomes a new unpublished copy with server identity removed.
Choose Fit and confirm both nodes and their connecting flow are present.

Runnable example

Flowboard Markdown

Copy this model into Import in the editor. Export current work first. The two stable identifiers, api and db, connect the services to the flow.

# Request path

- API {#api type=service x=100 y=120}
- Database {#db type=database x=500 y=120}

## Flows
- api -> db {#requests label="requests" color=#f05a47 speed=1 direction=forward}

Change a label to describe your system. Keep the identifiers the same when you want existing connections to keep referring to those nodes.

Check your work

Expected outcomeTwo nodes and one flow survive a portable export and re-import.

Next steps

Try the workflow in the editor, then use the reference for control details and model syntax.

Open the example or setup page Detailed reference

If a step does not work, keep an export of your model and follow the troubleshooting guide. Include the error message when contacting support, without sharing credentials or private architecture.