Export as Markdown or DITA

Export your map's content as Markdown or DITA XML files for use in other tools, version control, or archival.

Export as Markdown

Open a map and scroll to Publication Targets.
Click Export as Markdown on a target.
A .zip file downloads containing one .md file per topic.

The exported files preserve the map's folder hierarchy — nested topics are placed in subdirectories matching the map structure.

Content is resolved through the publishing pipeline before export: components are expanded, conditions are filtered, and variables are substituted based on the target's settings.

Export as DITA

Open a target and select Export as DITA (or add ?format=dita to the export URL).
A .zip file downloads containing:
- One .dita file per topic
- A .ditamap file reflecting the map hierarchy

DITA export converts topics into standard DITA XML concepts, tasks, and references based on the topic type.

What's preserved per format

Content element	Markdown export	DITA export
Headings	Preserved as `#` levels	Preserved as `<section>` / `<title>`
Bold, italic, code	Preserved	Preserved as `<b>`, `<i>`, `<codeph>`
Images	Preserved with relative paths	Preserved as `<image>` elements
Tables	Preserved as GFM tables	Preserved as `<simpletable>`
Ordered/unordered lists	Preserved	Preserved as `<ol>` / `<ul>`
Code blocks	Preserved with language tags	Preserved as `<codeblock>`
Callouts/admonitions	Converted to blockquotes	Preserved as `<note>` elements
Component references	Expanded (resolved content)	Expanded (resolved content)
Variable tokens	Substituted with values	Substituted with values
Conditional blocks	Filtered per target profile	Filtered per target profile
Internal cross-references	Converted to relative `.md` links	Converted to `<xref>` elements

Some structural features may not round-trip perfectly. Topicary's rich editor supports elements like tabbed code groups, embedded videos, and custom callout styles that have no direct Markdown or DITA equivalent. These are converted to the closest available representation. Review the exported files if you plan to import them into another system.

Export a single topic

Open a topic in the editor.
Click the three-dot menu.
Select Export as Markdown (or Export as DITA).
The file downloads directly.

Single-topic exports also resolve components and variables through the pipeline.

Export as Markdown or DITA