Export content
Export your map's content as Markdown, DITA XML, Word (.docx), OKF (agent knowledge bundle), or XLIFF 2.0 files for use in other tools, version control, translation, or archival.
Markdown export is available on every plan. DITA, Word, OKF, and XLIFF export require the Business plan.
Open the Export dialog
All file exports for a target run from one place:
Open a map and scroll to Publication Targets.
Click Export… on the target.
The Export dialog opens, listing every format grouped by audience:
For people: PDF, Word, Markdown
For AI & agents: OKF (agent knowledge bundle), RAG bundle, plus live endpoints (llms-full.txt, per-page Markdown, MCP)
For other systems: XLIFF, DITA
Click Download next to a downloadable format. Endpoint-based outputs (the live ones) show a Copy URL button instead.
The steps below describe what each downloadable file contains.
Markdown
Downloads a .zip containing one .md file for each 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.
DITA
Downloads a .zip containing:
One
.ditafile for each topicA
.ditamapfile reflecting the map hierarchy
DITA export converts topics into standard DITA XML concepts, tasks, and references based on the topic type.
What is preserved for each format
Content element | Markdown export | DITA export | Word export | XLIFF export |
|---|---|---|---|---|
Headings | Preserved as | Preserved as | Preserved as Word heading styles | Preserved as segments |
Bold, italic, code | Preserved | Preserved as | Preserved as Word formatting | Preserved as inline elements |
Images | Preserved with relative paths | Preserved as | Embedded in document | Not included |
Tables | Preserved as GFM tables | Preserved as | Preserved as Word tables | Preserved as segments |
Ordered/unordered lists | Preserved | Preserved as | Preserved as Word lists | Preserved as segments |
Code blocks | Preserved with language tags | Preserved as | Preserved as monospace blocks | Preserved as segments |
Callouts/admonitions | Converted to blockquotes | Preserved as | Converted to styled paragraphs | Preserved as segments |
Component references | Expanded (resolved content) | Expanded (resolved content) | Expanded (resolved content) | Expanded (resolved content) |
Variable tokens | Substituted with values | Substituted with values | Substituted with values | Preserved for translators |
Conditional blocks | Filtered for each target profile | Filtered for each target profile | Filtered for each target profile | Preserved for translators |
Internal cross-references | Converted to relative | Converted to | Converted to internal links | Preserved as segments |
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.
The file downloads directly.
Single-topic export resolves component references before download. Conditions and variables are not resolved for a single topic, because there is no publication target to supply a condition profile or variable set.
Word (.docx)
Downloads a .docx file containing all topics formatted as a Word document. Word export preserves headings, lists, tables, images, bold, italic, and code formatting. Content is resolved through the publishing pipeline before export, so components are expanded, conditions are filtered, and variables are substituted.
OKF (agent knowledge bundle)
Downloads a .zip with Markdown content and typed metadata. OKF is Google's open Agent Knowledge Format: Markdown pages paired with structured metadata so AI agents and retrieval systems can consume your documentation. OKF export is available at the map level, not for a single topic.
XLIFF 2.0
Downloads a .zip containing one .xliff file per locale with source and target segments. XLIFF export is designed for translation workflows. It preserves conditional blocks and variable tokens in the exported segments so translators can see and work around them without breaking the content structure. Import the completed XLIFF files back through the translation panel.
See also
Publish a web site: publish as a live documentation site instead of exporting static files
Generate a PDF: another output format for offline distribution
Import formats: supported formats for importing content into Topicary
The publishing pipeline: how components, conditions, and variables are resolved before export
Topic types: topic types determine DITA element mapping during export