Updating pages

Files exported by Markup bridge remember the page they came from. Importing them again can update those pages, instead of creating copies.

The page header

Each exported file starts with a header. In Markdown, it’s front matter:

---
title: "Onboarding"
confluence-page-id: "1081345"
confluence-version: 7
confluence-space: "ENG"
---

AsciiDoc puts the same fields in the document attributes, reStructuredText in a field list at the top, and Typst and LaTeX in comments on the first lines.

  • title becomes the page title. Change it to rename the page.
  • confluence-page-id is the page the file updates.
  • confluence-version is the page’s version when it was exported.
  • confluence-space is the space the page is in.

Keep the header when you edit a file. A file without one is imported as a new page.

Update pages

  1. Open the page you exported, or the page above it.
  2. Choose ••• › Apps › Markup: Import…, and choose the edited file or zip.
  3. In the preview, the pages that will be updated are marked from Confluence.
  4. Choose Update the pages the files were exported from, then Import.

Files without a header, such as a page you added, become new pages under the page you imported on.

Pages edited in Confluence since the export

Before updating a page, Markup bridge compares the page’s version with the version in the file. If someone edited the page in Confluence after the export, the page is left unchanged, and the dialog lists it:

Onboarding was edited in Confluence after it was exported (version 9, the file has 7), so it was left unchanged.

To replace those edits with the file, tick Also overwrite pages edited in Confluence since the export. The earlier versions stay in the page history.

To keep both, export the page again, merge the changes into the new file, and import that.

Pages from another space

A file whose page is in a different space from the page you’re importing on is imported as a new page. The dialog lists it. This is how to copy pages from one space to another.

A Git workflow

  1. Export the page tree and commit the files.
  2. Edit the files in branches and review the changes as pull requests.
  3. After merging, zip the folder and import it with Update the pages the files were exported from.
  4. Export again and commit, so the files carry the new version numbers.

Step 4 matters: without it, the next import sees every page as edited since the export.