MkDocs で OpenAPI ドキュメントを表示する¶

MkDocs で OpenAPI ドキュメントを表示するには plugin を使う。 調べたところ 4 つの plugin で OpenAPI ドキュメントを表示できることがわかった。

1. mkdocs-render-swagger-plugin
2. mkdocs-swagger-ui-tag
3. neoteroi-mkdocs
4. mkdocs-redoc-tag

表示形式は次の表のとおり。Swagger UI を細かく設定したい場合は、mkdocs-swagger-ui-tag の設定オプションを確認するとよい。