Favor human‑readable text with minimal markup so notes remain accessible decades from now. Store images and PDFs beside notes with relative links, not hidden blobs. Use alt text, captions, and descriptive filenames. When exporting, ensure embedded media become portable files within stable, replicable directory structures.
Let structure carry context. Front matter in YAML or JSON captures tags, aliases, and canonical IDs that travel between tools. RDF and schema.org express relationships machines can reason about. Export these fields consistently, and your collections, backlinks, and queries reappear with minimal friction after every migration.
Standards turn walls into doors. WebDAV synchronizes files across servers you control. CalDAV and CardDAV keep calendars and contacts portable across apps and devices. Well‑documented REST or GraphQL APIs enable scripted exports and imports. Prefer endpoints that deliver complete, rate‑limit‑friendly access, including attachments, revisions, and deletion options.
Choose link forms that multiple apps recognize. Markdown links work almost everywhere, and double‑bracket wiki‑links are widely supported. Keep aliases in metadata to preserve autolinks. Avoid app‑specific block tokens unless they map to anchors during export. Test a sample vault in another tool and confirm everything resolves.
Front matter fields like title, tags, created, modified, aliases, and IDs should export with consistent keys and predictable casing. Maintain a changelog of mapping decisions. If your source stores attributes in a database, ensure the export writes them alongside each note so indexing and linking remain intact.