nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Confluence Tables in PDF

Laura Schneider

I've tried every combination of fixed, auto, and specific %s for the following code:

table,table.fixedTableLayout,table.responsiveTableLayout
{
table-layout: fixed !important;
width: fixed !important;
}

...each in combination with test tables that, in the Confluence editor, are selected to be either "Fixed width" or "Responsive" from the menu, and contain small to large quantities of text (to force column widths to expand/contract, if they are not responding to the "fixed" commands).

I have found no combinations of this that result in a predictable, let alone WYSIWYG, output to PDF. This seems like a massive Confluence bug since CSS is validating correctly on https://jigsaw.w3.org/css-validator/.

Before I waste any more time,

(1) has ANYONE found a solution to this that does NOT involve a 3rd party plug-in?

(2) if you get WSIWYG tables using a plug-in, which one and do you recommend it?

Thank you!

--Laura

Accepted answers

Matt Reiner _K15t_

Hi Laura!

I know @Robert Lauriston @Sharon Metzger and @Nancy Hutson Hale have some experience with this.

Reminds me of this thread: https://community.atlassian.com/t5/Answers-Developer-Questions/Documentation-PDF-export-a-la-Atlassian-s/qaq-p/486060 where Robert mentions they use https://itextpdf.com/en. Baybe this will help.

Good luck!

Herve Frydlender

Hi,

I also struggled with tables / columns width, and succeeded to have a correct result using :

table {
    table-layout: auto !important;
    width: auto !important;
    word-wrap: normal;
}

What changes everything was addition of word-wrap property.

All comments

Matt Reiner _K15t_

Hi Laura!

I know @Robert Lauriston @Sharon Metzger and @Nancy Hutson Hale have some experience with this.

Good luck!

Sharon Metzger

Hi Laura and Matt --

I haven't done PDF output in a couple years now, but I think my best solution with table column widths was this:

* Use Scroll PDF Exporter
* Use the "Scroll Table Layout" macro (one per table in the Confluence pages) to define relative column widths (e.g., "20%,80%" "25%,25%,50%", etc)

Laura Schneider

Thanks, @Matt Reiner _K15t_ . That's good to know about itextpdf.

@Sharon Metzger thanks, that sounds perfect for some folks who may be looking for this answer and already have Scroll PDF Exporter! It sounds like a great tool for some users who can afford it; numerous folks have recommended it for solving all kinds of bugs and short-comings in Confluence's built-in functionality.

Unfortunately, Scroll PDF Exporter would cost multi-$thousands/year on top of a multi-$thousand upfront cost. This is right out for my tiny department's needs, and even so manually defining the percent of each column in each table is wayyy beyond reasonable for a tool that expensive: it would be far cheaper for us to hire a temp to retype the docs on a Smith-Corona then scan to PDF every time we do a release if that needed to be manually adjusted and tested for each table: that would be a pain almost equal to my current situation with the default Confluence random output. Hours of testing for constantly changing table content is impractical.

Does anyone ( @Sharon Metzger , @Robert Lauriston , @Nancy Hutson Hale ) know what controls the outcome in the PDF? I can detect no particular pattern that I can document for my users, but there obviously is one. (Hours of painful testing is in my near future if nobody knows this; I'm hoping that Atlassian responds to this directly.) I'm astonished that Confluence/Atlassian doesn't have that basic out-of-the-box functionality documented.

Even remotely WYSIWYG should be possible; this is a massive feature-gap in Confluence.

Sharon Metzger

Yes, I understand I didn't address your needs, unfortunately, just responding to Matt's callout. But I feel your pain, and table formatting is one of the reasons (page breaks is another) I abandoned native PDF export for Scroll PDF export, and eventually abandoned PDF entirely.

(I use Scroll Viewport now for delivery, on a separate Confluence instance with the minimum license tier.)

I see from Inspecting a Confluence page in a browser that tables use role="grid", role="row", etc. I'm not familiar with the role element, but wonder if those bits are complicating PDF exports? Not that I have any idea what to do with that.

Robert Lauriston

You don't need to install Scroll PDF Exporter in your corporate or customer-facing Confluence instance. Set up an instance with only enough licenses for the people who need to publish to PDF.

Laura Schneider

Thanks, @Robert Lauriston . I'm just focusing on getting Confluence's basic functionality to work. I'll troubleshoot the existing tables and iterate to solutions for the content we have. I'm getting no responses from Confluence at all on this, unfortunately, so apparently they are ignoring the issues with their PDF export functionality.

Scroll PDF Exporter is simply not an option due to its price. The installation and licensing options were apparently researched thoroughly, and the implementation is too expensive by tens of thousands of dollars. Myself, I hesitate to invest more dollars and time in any stop-gap solution such as purchasing a plug-in or add-on software that attempts to patch expensive, high-end yet sub-optimal software to begin with. Good money after bad, as they say.

Sharon Metzger

What Robert is pointing out is that if you can set up another instance of Confluence, the PDF Exporter is only USD10/year for up to 10 users. (A Confluence Server instance is also USD10/year for up to 10 users.) It's relatively straightforward to export Confluence files from one instance and import them on another.

Also, I hear you about preferring to avoid add-ons, but honestly, life with Confluence got much easier once I embraced the fact that people like those at k15t and Comala Tech were fighting the good fight for me -- using Confluence add-ons is good and necessary if you're going to use Confluence as any kind of professional publishing platform.

Robert Lauriston

Atlassian has de facto outsourced to K15t all the things you need to create, maintain, and publish technical documentation. They're not going to put any resources into adding or improving native features that duplicate what you can do with Scroll plugins. There has been no significant improvement to the native PDF export in years.

https://community.atlassian.com/t5/Answers-Developer-Questions/Documentation-PDF-export-a-la-Atlassian-s/qaq-p/486060

Kevin Marlowe

I was having the same issue with format of tables while exporting to PDF.

I found the below code entered into PDF Export Stylesheet fixed the issue

/*TABLE*/
table {
table-layout: fixed !important;
width: 98% !important;
}

I hope this helps correct your issue.

Regards

Laura Schneider

@Kevin Marlowe Thank you so much for sharing your code! Regrettably, this doesn't help me, however. I've been testing versions of this for a few days now, on and off. And so my search continues. Thanks for your help, however, as this might solve someone else's problem!

--Laura

Here's what I'm seeing...

The code you provided causes the following on my system:

Line 1) table-layout: fixed !important;

This code seems to be ignored regardless of the table composition/appearance in Confluence and regardless of whether I include your second line (below). It /should/ work, I think, but it doesn't seem to be.

Line 2) width: 98% !important;

This code causes all tables to be 100% of the PDF page width, with equally sized columns, regardless of the original size or content of the cells in the columns. Example: A table with a column containing a single character, "X", is the same width (49%) in the PDF as a column containing "supercalifragilisticexpialidocious test test test test test test test test test test test test test test test test test test test test test test test test test", which is clearly not what I want.

So, what I'm seeing is that, when text wraps in cells in the Confluence text editor, this command causes my table columns in the PDF to end up scaling out across the PDF page to some relative width that allows the text to wrap, up to 100% of the available CSS-defined page width. Some columns come out way too skinny with odd text wraps, some come out oddly too wide. They do not stay proportional to the original table's appearance in Confluence, either. This is highly undesirable. I cannot, for example, get one table column to avoid wrapping a column of dates at the "/" mark, although there is plenty of room on the page. That last seems to be a character issue as much as anything, but it is similarly frustrating with simple numbered rows in a table, for example part numbers and descriptions of the part.

I've tried manually editing the HTML to set the width at a particular px in the confluence editor, but that did not translate to the PDF either which surprised me. Still investigating and testing manually editing this, however, and working with the CSS controls.

It seems like the Confluence "Export to PDF" generator function might be non-compliant with W3C--or it is being overridden by something--when it comes to creating the PDF file based on my CSS, however. I say this because literally printing the Confluence page and saving it as a PDF (CTRL-P using the "Adobe PDF" printer driver or the "Save as PDF" option) creates a more reliable PDF file with respect to the layout of the tables. I would use this, except that it includes all of the headers, footers, and default graphic stuff that you need to use the Confluence content but that is inappropriate to print, and it prevents you from using CSS to create the headers and title page and other things.

Kevin Marlowe

Happy to help,

Just for reference, I used this page to help with the code I entered - Link

Maybe it could help

Thanks

Robert Lauriston

You can get 30-day free trials of Confluence Server and Scroll HTML Exporter, install them locally, export your content from the main instance, import it into the local instance, and get your PDFs to look any way you like.

If you're happy with that, it'll cost $20 to use that solution indefinitely.

You're not creating any shareholder value by extended experiments proving that Confluence's native PDF export sucks.

Herve Frydlender

Hi,

I also struggled with tables / columns width, and succeeded to have a correct result using :

table {
    table-layout: auto !important;
    width: auto !important;
    word-wrap: normal;
}

What changes everything was addition of word-wrap property.

Laura Schneider

WOW! Thank you @Herve Frydlender

This helps tremendously! Thank you so much. It's not the answer to all of my problems, but gets me much closer to my endpoint. I really appreciate this. (The word-wrap is indeed the key I was missing.)

Cheers!

Alexandre Courchesne

To fix some column width when exporting my pages to PDF, the simplest way I found was to put a « white » image to fix the length of the column. In the PDF document the image will force the min-size of the column to the size of the image.

It's a simple fix, but it saved my ass multiple times!

Laura Schneider

Love this work-around! Thanks!

Merry Sweet

Thanks for these combinations need to try them too. You know I'm not a specialist in this domain but as I'm a student I need to work a lot with word documents and, of course, PDF format docs. Actually, recently I prepared a report about new inventions and my teacher told me to make some changes. As I saved everything in PDF I used this pdf-ocr.com converter in order to convert the document in online word and be able to edit it. So this is the only thing that I did hehe. It is not so much lol thanks again for teaching me new things.

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

confluence

server

confluence-server