June 26, 2026

How to draw and document chemical structures in Confluence

Step-by-step guide to embedding a molecular structure in a Confluence page with the Chemical Structures macro — no SMILES strings, no screenshots from ChemDraw.

tutorialchemical-structures

The standard workflow for adding a molecule to a Confluence page is to open ChemDraw or MarvinSketch, draw the structure, export as PNG, paste the image, and move on. Two weeks later someone updates the synthesis and the screenshot is wrong — but it still looks authoritative on the page.

Chemical Structures for Confluence replaces that workflow with a macro that stores the actual molecule, not a picture of one. Here’s how to use it.

1. Insert the macro

In any Confluence page in edit mode, type /chemistry or /chem. The Chemical Structures macro appears in the suggestions — select it to open the editor.

Inserting the Chemical Structures macro in Confluence edit mode

2. Draw your structure in Ketcher

The editor embeds Ketcher — the same open-source structure editor used by PubChem. If you’ve used ChemDraw, the controls are immediately familiar:

  • Click a bond type in the toolbar, then click the canvas to place it
  • Click an atom label to change the element
  • Use wedge bonds for stereocenters
  • Right-click any atom or bond to access stereo options, charges, and isotope labels

Draw the molecule — aspirin, penicillin, a custom drug candidate, whatever you’re documenting.

Ketcher editor open inside Confluence with a molecule drawn

Already have a SMILES string or a Molfile? Use the Import button in the toolbar to paste it directly. Ketcher renders it and converts it to a 2D layout automatically.

3. Save and publish

Click Insert (or Save if editing an existing structure). The editor closes and the page preview shows the rendered structure as a clean vector image. Save the page normally.

4. What viewers see

Anyone viewing the page sees the molecule as a scalable SVG — crisp at any zoom level, readable on mobile, and properly styled in both light and dark mode. No pixelation, no “download the original file to see it” messages.

Rendered molecule on the published Confluence page

Authors with edit access can click the structure to reopen the full Ketcher editor. No desktop software, no plugin, no file downloads.

5. Export to Word and PDF

When the Confluence page is exported to Word or PDF, the structure renders exactly as it appears on screen — same scale, same layout, same bonds. It doesn’t revert to a broken image reference or a placeholder box.

What gets stored

The macro stores the complete Molfile with 2D coordinates — not a SMILES string, not a lossy image. Stereocenters, chair conformations, wedge bonds, and explicit hydrogens are all preserved. What you drew is what the macro renders, every time.


For pharmaceutical R&D teams: structures stored in Confluence via this macro never leave Atlassian’s infrastructure — the app runs on Atlassian Forge with no third-party chemistry backend. See the product page for details on the data-residency angle.

Try it: Chemical Structures for Confluence.