{"categories":[{"label":"Text Processing","url":"https://skillfed.io/packages/category/text-processing/2"},{"label":"Documentation","url":"https://skillfed.io/packages/category/documentation"}],"enrichment":{"capability":"A MkDocs plugin that embeds Swagger UI directly into documentation pages to display OpenAPI specifications, supporting both remote URLs and local files.","skillfed_tags":["api-documentation","mkdocs-plugin","openapi"],"use_cases":["Embed API documentation directly in MkDocs sites alongside other guides and tutorials without maintaining separate Swagger UI hosting.","Display multiple OpenAPI specs in one documentation site with a selector bar to switch between them.","Support OAuth2-protected API testing in embedded Swagger UI with configurable redirect URLs.","Serve Swagger UI entirely from local assets in air-gapped or intranet environments without CDN access.","Customize Swagger UI appearance and behavior per-page through tag attributes while keeping global defaults in mkdocs.yml."],"what_it_does":"This plugin extends MkDocs by allowing you to embed interactive Swagger UI viewers directly into your documentation pages using a simple HTML tag. Instead of linking to external API documentation or hosting Swagger UI separately, you add a `<swagger-ui>` tag pointing to an OpenAPI specification file\u2014either a remote URL or a local file in your docs folder\u2014and the plugin converts it into an embedded iframe with full Swagger UI functionality.\n\nThe plugin handles all the heavy lifting: it copies Swagger UI's JavaScript and CSS assets into your site's static directories, generates the necessary iframe HTML, and supports multiple Swagger UIs on the same page. It integrates with Material for MkDocs' dark mode, lets you configure Swagger UI behavior through plugin options (like operation expansion, syntax highlighting theme, and Try It Out settings), and supports OAuth2 flows. All assets are served locally rather than from a CDN, making it suitable for intranet deployments.","worth_installing":"Yes. The plugin is actively maintained, has no known vulnerabilities, installs with minimal friction, and solves a real problem for teams documenting APIs in MkDocs. It's particularly valuable if you want to avoid hosting Swagger UI separately or need to serve API docs in restricted network environments."},"id":"mkdocs-swagger-ui-tag","links":{"html":"https://skillfed.io/packages/mkdocs-swagger-ui-tag","md":"https://skillfed.io/packages/mkdocs-swagger-ui-tag.md","pypi":"https://pypi.org/project/mkdocs-swagger-ui-tag/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-07-10","license_spdx":"MIT","license_treatment":"permissive","name":"mkdocs-swagger-ui-tag","python_support":"supports_current","summary":"A MkDocs plugin supports for add Swagger UI in page."},"popularity":{"monthly_downloads":283110,"position":8080,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"0.8.1"}
