Migration guides

Migrate Markdown files to Equilibrition with a guided CSV

A Markdown folder is often the most portable foundation for a knowledge base. The migration should keep the text readable and create only the Equilibrition objects that make sense.

Starting format

Markdown or ZIP converted to CSV

CSV

CSV import available today

The reliable path today is to upload one file, multiple files, or a ZIP, prepare a notes-and-metadata CSV, import that CSV into Equilibrition, then review linked files.

Path

The 3 migration steps

Gather Markdown files

Prepare one `.md` file, multiple files, or a complete ZIP. Keep folders, images, and relative files so links can be understood.

Do not rename files before conversion if relative links exist.
Proprietary extensions can be preserved as raw text.

Import the CSV into Equilibrition

CSV import works today. Convert Markdown into a CSV with content, frontmatter, source path, links, and candidate tasks, then import that file into Equilibrition.

YAML and TOML become reviewable metadata.
Checkboxes become candidate tasks only with consent.

Review the mapping

Review notes, folders, tags, internal links, anchors, and files before using Equilibrition as the primary source.

Folders can become context, domain, or project depending on real usage.
Unrecognized elements stay visible in the import report.

Mapping

What becomes what in Equilibrition

In the source tool	In Equilibrition	Review point
Standard Markdown	Tiptap note	Editable content is preserved as much as possible.
YAML/TOML frontmatter	Metadata	Each key remains visible in preview.
Folder	Context	Can be confirmed as domain, project, or simple provenance.
Links and anchors	Links	Relative links are resolved when the target is present.
Images and relative files	Private files	Attached to the source note with a warning if missing.

Watchouts

Limits to know before importing

Proprietary extensions remain raw text with a warning.
Checkboxes are not converted into tasks without explicit review.
The import CSV should remain the reviewable version before deeper automation.

Coming later

This Markdown engine will underpin Obsidian and Logseq adapters, but the published path today remains guided CSV import.

Founder Pass

Ready to bring your context into a clearer cockpit?

The Founder Pass gives access to the first CSV imports, priority feedback loops, and a lifetime locked-in price.

Claim the Founder Pass — €97