How best to format Confluence Knowledge Base (KB) Content with JIRA Service Desk?

Currently running into JIRA Service desk and Confluence KB Content merging into one beautiful way to support customers (crossing fingers).


Noticing that our formatting using tables isn't integrating well.


Confluence Tables can show on JIRA Service Desk as...

  • necessary side scrolling :( 

Curious about tips/ideas/templates related to styles of How-To Guides that look more clean to customers and at the same time aren't too much trouble to edit. (some Macros in Confluence can be a little clunky)

1 answer

Formatting a Confluence Knowledge Base is completely up to the users and creators preference. The only think I can really do is give you an idea of how I formatted my Confluence Knowledge Base to work with JSD.


Although, it would be easier to do this over some sort of chat, I will do my best to explain... Confluence is based on Hierarchy, as you know:

  • All of my main pages contain the macro {children display} so if users somehow navigate to that page, they can see all of the chilren pages of the main page. 
  • Under the main page I create children pages that are directly related to the main pages topic (i.e. Main page named Connections - Children Pages could be Common Connection Issues, VPN Connection, Connecting to WiFi and so on)
  • I utilize the {word and {excel documents for procedural documentation. There is a setting you can turn on so you can edit Microsft Documents within Confluence. 
  • I set my Knowledge Base to "Anonymus Access" meaning a lot of users can view it but only certain people can edit.
  • I use Labels to group together relatable content and on the bottom of each page I use the macro {Conent by Label to display relatable information

Is this the type of stuff you are looking for? I really enjoy formatting Confluence to be friendly with JSD but everyone has a different approach.

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Feb 06, 2019 in Confluence

Try out the new editing experience

Hi team, I’m Avinoam, a product manager on Confluence Cloud, and today I’m really excited to let the Community know that all customers can now try out the new editing experience and see some of the ...

1,124 views 60 8
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you