Visual documents

Markdown to PDF with images and tables

Images and tables are often the hardest elements to move from a screen to a page. With simple structure and accessible resources, you can preserve the information without horizontal scrolling or awkward clipping.

Practical guide · 6 min

Quick rules

Use accessible HTTPS images with descriptive alternative text.
Keep tables focused: fewer columns and concise content.
State the important conclusion in text instead of relying on an image.

Prepare a page that adapts

Describe each image
Alternative text should explain what the image contributes rather than saying “image of.” It also helps when the resource cannot load.
Confirm availability
Local paths do not travel with the document. Use a public HTTPS address that can load the image, or prepare the file without that resource.
Simplify tables
Split tables with too many columns and shorten values. Landscape orientation offers more room, but the result should remain easy to read.
Inspect the preview
Check that important information is not clipped. Switch to landscape only when the content genuinely needs it.

Visual documents

Edit a page with a table and image

The example combines a public image, a compact table, and a conclusion that still makes sense without the visual resource.

Open in converter

You can edit the example here. Opening it in the converter loads the original version so you can export it.

Editable Markdown

Preview

Documentation summary

The review covers the three primary content formats.

Element	Status	Next action
Text	Ready	Proofread
Tables	Ready	Validate on A4
Code	In progress	Add examples

Conclusion

The structure is ready to share. Before exporting, we will check that the complete table is readable in the preview.

An image supports the content; it should not replace the explanation.

Avoid these problems

Do not use private images that require sign-in: the browser may not be able to include them.
Do not turn entire spreadsheets into one Markdown table; summarize the essential data.
If an image contains small text, add a readable explanation below it.

Frequently asked questions

Can I use images from my computer?

A local path written in Markdown is not portable. This version requires an accessible HTTPS URL.

What should I do with a very wide table?

Reduce or split its columns. As a second option, switch the page to landscape orientation.