Troubleshooting

The dialogs list everything that didn’t go as expected when they finish. The messages below are grouped by where they appear. If something isn’t covered here, email support with the message the dialog showed.

Starting the app

Markup needs a subscription on this site. The site has no active trial or subscription. A site admin can start one under Settings › Apps › Manage apps. See Installing.

The app couldn’t start. The dialog couldn’t load, usually because of a network problem or a browser extension that blocks scripts. Reload the page and try again. If it keeps happening, try a private window with extensions turned off.

Open this from a page’s ••• menu. The dialog was opened some other way. Open a page and use ••• › Apps.

Exporting

Only the first 500 pages and folders were exported. The page tree is larger than one export can hold. Export the sections of the tree separately.

N attachment(s) were left out because the export reached its size limit. The attachments add up to more than 500 MB. Export smaller parts of the tree.

N whiteboard(s), database(s) or Smart Link(s) in the page tree can’t be exported. These aren’t pages, and have no text form. The rest of the tree is exported.

N image(s) belong to pages outside this export and were linked, not included. The page shows images attached to a different page. They’re linked by their Confluence address. Export the other page too, or attach the images to this page.

“File” on “Page” couldn’t be downloaded. Confluence didn’t return the attachment. Check that it opens in Confluence, then export again.

Importing

There are no Markdown, AsciiDoc, reStructuredText, Typst or LaTeX files to import. The zip has no files with a supported extension.

The zip is too large to import (over 1 GB unpacked). Split the files into several zips, and import them one at a time.

The image X isn’t in the import. A file shows an image that isn’t in the zip. Add the image at the path the file uses, or remove the reference. The page is still imported, without the image.

Page was edited in Confluence after it was exported, so it was left unchanged. See Pages edited in Confluence since the export.

Page came from another space, so a new page was created. See Pages from another space.

A page called “Page” already exists in this space, so it was imported as “Page (2)”. Page titles are unique within a space. Rename or move the existing page and import again, or rename the imported page.

X was skipped: Y has the same name. Two files would become pages with the same title in the same place, such as Guide.md and Guide.adoc. Remove one of them.

The import stopped. Import again to carry on where it stopped. The connection dropped or Confluence returned an error part-way. Choose the same files under the same page and import again; pages that were already imported aren’t duplicated. See Interrupted imports.

Rendering exported files

LaTeX can’t find confluence.sty, or Typst can’t find confluence.typ. The helper file has to stay in the top folder of the export, where the pages expect it.

Typst says a path “would escape the project root”. A page in a subfolder loads ../confluence.typ, which is outside the folder Typst allows by default. Compile with --root set to the top folder of the export, such as typst compile --root . "Team handbook/Page.typ".

Arabic or Hebrew text is in the wrong order in the PDF. Compile with XeLaTeX or Tectonic, not pdfLaTeX.