Skip to main content

MkDocs plugin to embed AsyncAPI HTML viewer in your markdown file.

Project description

mkdocs-asyncapi-plugin

This plugin helps to render AsycnAPI schema in your mkdocs markdown page. It uses AsyncAPI Standalone react component to render your asyncapi schema file.

Supports both .json and .yml files. Simply use the tag:

<asyncapi-tag src="/path/to/schema.json"/>

Accepted values

In addition to the src attribute following attributes work with the tag.

Action Attribute Accepted values
Show or hide sidebar true or false
Show or hide info true or false
Show or hide servers true or false
Show or hide operations true or false
Show or hide messages true or false
Show or hide schemas true or false
Show or hide errors true or false
expand or collapse messageExamples true or false
sidebar configuration showServers byDefault or bySpecTags or byServersTags
sidebar configuration showOperations byDefault or bySpecTags or byServersTags
asyncapi parser configuration parserOptions See available options here
label customization publishLabel Any string value
label customization subscribeLabel Any string value

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mkdocs-asyncapi-tag-plugin-0.2.0.tar.gz (5.2 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file mkdocs-asyncapi-tag-plugin-0.2.0.tar.gz.

File metadata

File hashes

Hashes for mkdocs-asyncapi-tag-plugin-0.2.0.tar.gz
Algorithm Hash digest
SHA256 df6017449127e20ac12e2727d3bb697d2b033199841fa053991ad11ab972db8f
MD5 ac0dae6dc04c2c4daf46cf195f27c253
BLAKE2b-256 f52ebc705bfa7285df8abfcb1904596866d18aec3fb94f3f4aadbba9c5a95a11

See more details on using hashes here.

File details

Details for the file mkdocs_asyncapi_tag_plugin-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mkdocs_asyncapi_tag_plugin-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bc9f4d03349c88fd5162177843e668542166c05f2049586185d08819a9896a46
MD5 acebe8013d713a2b0f643802d6187426
BLAKE2b-256 82a3a3d9ed35fb892fdc887288682fb0fd4c0e2a3fcb0aaa116b24e049042403

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page