Using Quarto to create Confluence pages

confluence
quarto
productivity
Published

March 8, 2024

Quarto is a great publishing system for charts and graphs. It allows you to generate data visualizations with Python and Plotly, Observable or whatever. Confluence is a documentation system, often used internally within companies for technical documentation. This website is created with Quarto. You can publish from Quarto to Confluence. I’m going to attempt that now.

Process

  1. Set up a new Quarto instance containing pages with a range of content, including generated graphs.
  2. Connect the Quarto instance to my personal Confluence account.
  3. Publish from Quarto to Confluence.
  4. Check the results - what what can and can’t be done.

The test

To test the connection I decided to use this website (which is on Quarto) as my test content. I made a copy of it in a new directory, then all I had to do was change the _quarto.yml to the following:

Then run the following command at the command line:

quarto publish confluence

It worked! This is this page, in Confluence: