adding a section on why this instead of directly quarto

[jcolomb]

Hello,

I see you have a good section on why using this plugin when you are already using mkdocs.

If I am new, what are the advantages of using this instead of just using quarto directly (quarto can also create documentation website)?

(I would make a PR, but I do not know the answer)

[jspaezp]

Hey there! Thanks for the interest in the project!

That is a good point! I will add that next when I update this guy.
Long story short... quarto is a markdown based format that allow execution of the code and captures the result.

My use case is that usually when I need to document a package, I would need to write the code and the expected output, with quarto I can write the code and the output gets generated for me!

The cool thing here is that I can sync the documentation of mkdocs with the build process of quarto. Then everything gets handled for me internally ... links between docs, theming, build process. Instead of me having to handle the sync manually.

Best!