How to fix `Prawn::Errors::CannotFit` during AsciiDoctor-PDF build

The most current version as of .

If you got a Prawn::Errors::CannotFit error when you try to generate a .pdf out of you .adoc using the asciidotor-pdf command?

This could be related to images placed in tables in your asciidoctor markup.

Does your asciidoctor include images in table cells?

| image:./some/image.png[Image ALt]

Then you should try adding a width to the image macros with a valid width value.

| image:./some/image.png[Image ALt, width=100%]

This should help you get rid of the exception and generate your .pdf.

— David Wolf