Spec

Export/Import Guidelines

Rules for importing and exporting StratMD documents

Export/Import Guidelines

Export Rules

  • Render all database tables as Markdown tables
  • Include narrative content as-is
  • Preserve all IDs and references
  • Generate valid YAML frontmatter

Import Rules

  • Parse tables into structured records
  • Preserve narrative content
  • Validate frontmatter schema
  • Resolve wiki-style links

Round-Trip Fidelity

Systems MUST preserve:

  • Table schemas and column order
  • Element IDs (B1, R2, O3, etc.)
  • Link references
  • Changelog entries

This ensures documents can move between StratMD-compatible systems without data loss.