Skip to content

Import formats

Topicary imports content from seven formats.

Format

Extensions

Max size

What's created

Markdown

.md, .markdown

5 MB

Topics

HTML

.html, .htm

5 MB

Topics

Word

.docx

5 MB

Topics

DITA

.dita, .ditamap, .xml

5 MB

Topics + map (from ditamap)

Confluence

.zip (HTML export)

50 MB

Topics + map (from page hierarchy)

MadCap Flare

.zip (project)

50 MB

Topics, components, map, variables, conditions

OpenAPI

.json, .yaml

5 MB

Topics (one per endpoint/schema)

Archive limits

  • Single files: 5 MB

  • Zip archives: 50 MB (200 MB decompressed)

The 50 MB limit applies to the compressed archive. The decompressed content must not exceed 200 MB. Imports that exceed either limit are rejected before processing begins.

What's preserved per format

Markdown

  • Title from # H1, YAML frontmatter title, or filename

  • Headings, bold, italic, strikethrough, inline code

  • Bullet lists, ordered lists, task lists

  • Tables, code blocks with language hints, blockquotes, images, links

HTML

  • Semantic elements (headings, paragraphs, lists, tables)

  • Images, links, code blocks

  • Basic inline formatting

Word (.docx)

  • Heading styles → headings

  • Lists, tables, images (extracted and uploaded)

  • Bold, italic, underline

Word import relies on Word's built-in heading styles (Heading 1, Heading 2, etc.) to detect document structure. Text that is merely bolded or enlarged but not styled as a heading imports as a regular paragraph. Apply proper heading styles in Word before importing for the best results.

DITA

  • Topic types (concept → Concept, task → Task, reference → Reference)

  • Ditamap hierarchy → map structure

  • Standard DITA elements → paragraphs, lists, tables, code blocks, notes

Confluence

  • Page content with Confluence chrome stripped

  • Info/warning/note macros → callouts

  • Code macros → code blocks

  • Page hierarchy → map structure

MadCap Flare

  • Topics → topics

  • Snippets → components (with references preserved)

  • TOC → map hierarchy

  • Variable definitions → variable sets

  • Condition tags → condition dimensions and values

Of all supported formats, MadCap Flare preserves the most content architecture. Snippets map to components, TOC maps to map hierarchy, variables and conditions carry over directly. If you are migrating from Flare, expect the smoothest transition.

OpenAPI

  • Endpoints → topics with method, path, parameters, schemas

  • Request/response examples preserved

See also

Was this page helpful?