# Wikinest Confluence Import

> Convert a Confluence HTML export into Wikinest pages in Markdown with the page tree. Reads the HTML export of a Confluence space (or pasted page HTML) and turns every page into Wikinest Markdown: headings, tables, lists, code, info/note/tip/warning panels, expand sections, status lozenges, task lists, mentions, dates and links between pages. The page tree is rebuilt from the breadcrumbs, and you get a Wikinest project file to open in the app.

Part of usefulweb.app (https://usefulweb.app/). Part of [Wikinest](https://wikinest.usefulweb.app/) (ownerApp: wikinest). Results are deterministic calculations from the inputs and the listed assumptions; the API returns exactly what the web page shows.

## Use it
- Human interface: https://wikinestconfluenceimport.usefulweb.app/ (interactive tool at https://wikinestconfluenceimport.usefulweb.app/tool)
- JSON API: POST https://wikinestconfluenceimport.usefulweb.app/api/v1/calculate with a JSON object of inputs (schema: https://wikinestconfluenceimport.usefulweb.app/api/v1/tool)
- OpenAPI: https://wikinestconfluenceimport.usefulweb.app/openapi.json
- MCP (Streamable HTTP): https://wikinestconfluenceimport.usefulweb.app/mcp - tool `wikinest_confluence_import`

## Inputs
- html (textarea): Confluence page HTML - Paste one exported page file, or several one after another. For a whole space, upload the export ZIP below instead.
- exportFile (file): Export file (.zip or .html, optional) - In Confluence: Space settings → Export space → HTML. Used instead of the pasted text when given.
- spaceName (text): Space name (optional) - Empty = the name in the export.

## Method
- Each page file is parsed by a small tolerant HTML parser. Title: the export’s title line without the “Space :” prefix. Parent: the last ancestor in the page’s breadcrumbs that is part of the export (matched by file name, by the title pattern of Confluence file names, or by link text).
- Body: the main-content area. Headings, paragraphs, bold/italic/strike, inline code, links, lists, tables (first row as header), quotes and rules become their Markdown forms; links to exported pages become [[Page]] links.
- Macros: information → :::info, note → :::warning, tip → :::success, warning → :::error, panel → :::info with its title, code → fenced code with the brush language, expand → :::expand, status → {status:colour|TEXT}, task lists → - [ ] / - [x], user links → @[Name], dates → {date:…}, table of contents → {{toc}}, child pages → {{children}}, emoticons → Unicode symbols.
- Images stored in the export (attachments/…) become attachment references (att:cf1, att:cf2 …); the app attaches the image files from the ZIP, this tool lists them. Unknown macros keep their text and are counted in the warnings.
- Pages are ordered parents first. The result is a Wikinest project file with one space; open it in the app with Open file, or import the ZIP there directly.

## Limits
- Confluence is a trademark of Atlassian. Wikinest reads the export files you provide; it does not connect to Confluence.