[Docs] Reduce the size of the built docs

[hmellor]

Reduces the total size of the built docs from ~350MB to ~310MB which is a ~11% reduction

[gemini-code-assist]

Code Review

This pull request focuses on reducing the built documentation size and improving markdown consistency. The key changes include adding the mkdocs-minify-plugin to minify assets and switching the markdown linter from pymarkdown to markdownlint-cli. The linter change has resulted in numerous formatting updates across the documentation, which generally improve consistency.

My review has identified a couple of high-severity issues. One is related to the new markdown linter configuration, where several important rules for link validation have been disabled globally. This could lead to broken links in the documentation. The other issue concerns some structural degradations in benchmarks/README.md where headings have been converted to plain text.

Overall, the PR is a good step towards better documentation infrastructure. Addressing the mentioned points will further improve the quality and maintainability of the docs.

[github-actions]

👋 Hi! Thank you for contributing to the vLLM project.

💬 Join our developer Slack at https://slack.vllm.ai to discuss your PR in #pr-reviews, coordinate on features in #feat- channels, or join special interest groups in #sig- channels.

Just a reminder: PRs would not trigger full CI run by default. Instead, it would only run fastcheck CI which starts running only a small and essential subset of CI tests to quickly catch errors. You can run other CI tests on top of those by going to your fastcheck build on Buildkite UI (linked in the PR checks section) and unblock them. If you do not have permission to unblock, ping simon-mo or khluu to add you in our Buildkite org.

Once the PR is approved and ready to go, your PR reviewer(s) can run CI to test the changes comprehensively before merging.

To run CI, PR reviewers can either: Add ready label to the PR or enable auto-merge.

🚀