Embed PDF files to view on the site

[ArtistYay]

Good afternoon guys,

As the title mentions, is there a way to embed a PDF on the website? I'm using GitHub pages. I know this has been brought up before #3050 (comment), but is there a more straightforward and more modern way than this 2021 version? Thank you

[kamilkrzyskow]

Hello @ArtistYay,
depends on what you'd call more straightforward or modern, but following the chain of links you've provided I've found the answer from 2024:

• https://stackoverflow.com/a/78697192
• https://github.com/ThomasTNO/mkdocs-pdf

By extending the "Markdown image links" the plugin allows for MkDocs to organically handle the relative path resolution.
The attributes are also set organically via attr_list.

The main difference is that the initial answer embedded the PDFs via object tag, and the plugin replaces the img tags with embed.
I've tried to find a clear answer for, what is better object or embed, but I could not find it. Both are valid.

Aside from that, the answer from 2021 seems a bit unfocused, like there is no need for the macros plugin.
MkDocs manages path only inside Markdown links, like [text](link) and image links, so by using an HTML <object> tag, the initial answer had to solve the path management as well with pathconverter.

I would go with the mkdocs-pdf plugin, as the alternative is a variant of the first answer or inputting HTML tags manually.

[ArtistYay]

Thank you good sir!