diff --git a/doc/swagger.rst b/doc/swagger.rst
index d63d7dfd..73df9a81 100644
--- a/doc/swagger.rst
+++ b/doc/swagger.rst
@@ -952,12 +952,12 @@ You can specify a custom validator URL by setting ``config.SWAGGER_VALIDATOR_URL
     api = Api(app)
 
 
-You can enable [OAuth2 Implicit Flow](https://oauth.net/2/grant-types/implicit/) for retrieving an
-authorization token for testing api endpoints interactively within Swagger UI.
-The ``config.SWAGGER_UI_OAUTH_CLIENT_ID`` and ``authorizationUrl`` and ``scopes``
-will be specific to your OAuth2 IDP configuration.
-The realm string is added as a query parameter to authorizationUrl and tokenUrl.
-These values are all public knowledge. No *client secret* is specified here.
+You can enable `OAuth2 Implicit Flow
+<https://oauth.net/2/grant-types/implicit/>`_ for retrieving an authorization
+token for testing api endpoints interactively within Swagger UI. The ``config.SWAGGER_UI_OAUTH_CLIENT_ID`` and ``authorizationUrl`` and ``scopes``
+will be specific to your OAuth2 IDP configuration. The realm string is added as
+a query parameter to authorizationUrl and tokenUrl. These values are all public
+knowledge. No *client secret* is specified here.
 .. Using PKCE instead of Implicit Flow depends on https://github.com/swagger-api/swagger-ui/issues/5348
 
 .. code-block:: python