mkdocs-material API reference
72 public APIs from mkdocs-material (squidfunk/mkdocs-material) — 32 classes, 6 functions, 34 methods. Signatures extracted by static analysis of the actual source.
Repository: squidfunk/mkdocs-material
| Kind | Count |
|---|---|
| Classes | 32 |
| Functions | 6 |
| Methods | 34 |
API list
method
material.extensions.preview.PreviewExtension.extendMarkdown(md:Markdown)Register Markdown extension.
method
material.extensions.preview.PreviewProcessor.run(root:Element)Run the treeprocessor.
func
material.extensions.preview.get_filter(settings:dict, key:str)Get file filter from settings.
func
material.extensions.preview.makeExtension(**kwargs)Register Markdown extension.
class
material.plugins.tags.plugin.TagsPluginA tags plugin.
method
material.plugins.tags.plugin.TagsPlugin.on_config(config:MkDocsConfig) -> NoneCreate mapping and listing managers.
method
material.plugins.tags.plugin.TagsPlugin.on_env(env:Environment, *config:MkDocsConfig, **kwargs) -> NonePopulate listings.
method
material.plugins.tags.plugin.TagsPlugin.on_page_context(context:TemplateContext, *page:Page, **kwargs) -> NoneAdd tag references to page context.
method
material.plugins.tags.plugin.TagsPlugin.on_page_markdown(markdown:str, *page:Page, *config:MkDocsConfig, **kwargs) -> strCollect tags and listings from page.
method
material.plugins.tags.plugin.TagsPlugin.on_startup(*command, **kwargs) -> NoneDetermine whether we're serving the site.
class
material.plugins.tags.renderer.RendererA renderer for tags and listings.
method
material.plugins.tags.renderer.Renderer.render(page:Page, name:str, **kwargs) -> strRender a template.
class
material.plugins.tags.structure.listing.ListingA listing of tags.
method
material.plugins.tags.structure.listing.Listing.add(mapping:Mapping, *hidden=True) -> NoneAdd mapping to listing.
class
material.plugins.tags.structure.listing.config.ListingConfigA listing configuration.
class
material.plugins.tags.structure.listing.manager.ListingManagerA listing manager.
method
material.plugins.tags.structure.listing.manager.ListingManager.add(page:Page, markdown:str) -> strAdd page.
method
material.plugins.tags.structure.listing.manager.ListingManager.closest(mapping:Mapping) -> list[Listing]Get listings for the mapping ordered by closeness.
func
material.plugins.tags.structure.listing.manager.toc.find(listing:Listing) -> tuple[AnchorLink | None, int]Find anchor link for the given listing.
class
material.plugins.tags.structure.listing.tree.ListingTreeA listing tree.
class
material.plugins.tags.structure.mapping.MappingA mapping between a page or link and a set of tags.
class
material.plugins.tags.structure.mapping.manager.MappingManagerA mapping manager.
method
material.plugins.tags.structure.mapping.manager.MappingManager.add(page:Page, markdown:str) -> Mapping | NoneAdd page.
method
material.plugins.tags.structure.mapping.manager.MappingManager.get(page:Page) -> Mapping | NoneGet mapping for page, if any.
class
material.plugins.tags.structure.mapping.storage.MappingStorageA mapping storage.
method
material.plugins.tags.structure.mapping.storage.MappingStorage.load(path:str) -> Iterable[Mapping]Load mappings from file.
method
material.plugins.tags.structure.mapping.storage.MappingStorage.save(path:str, mappings:Iterable[Mapping]) -> NoneSave mappings to file.
class
material.plugins.tags.structure.tag.TagA tag.
class
material.plugins.tags.structure.tag.options.TagSetSetting for a set of tags.
method
material.plugins.tags.structure.tag.options.TagSet.run_validation(value:object) -> set[Tag]Validate list of tags.
class
material.plugins.tags.structure.tag.reference.TagReferenceA tag reference.
method
material.plugins.tags.structure.tag.reference.TagReference.url() -> str | NoneReturn the URL of the tag reference.
class
material.utilities.filter.FileFilterA file filter.
class
material.utilities.filter.FilterA filter.
class
material.utilities.filter.config.FilterConfigA filter configuration.
class
src.extensions.preview.PreviewExtensionA Markdown extension to enable instant previews on links.
method
src.extensions.preview.PreviewExtension.extendMarkdown(md:Markdown)Register Markdown extension.
class
src.extensions.preview.PreviewProcessorA Markdown treeprocessor to enable instant previews on links.
method
src.extensions.preview.PreviewProcessor.run(root:Element)Run the treeprocessor.
func
src.extensions.preview.get_filter(settings:dict, key:str)Get file filter from settings.
func
src.extensions.preview.makeExtension(**kwargs)Register Markdown extension.
class
src.plugins.tags.plugin.TagsPluginA tags plugin.
method
src.plugins.tags.plugin.TagsPlugin.on_config(config:MkDocsConfig) -> NoneCreate mapping and listing managers.
method
src.plugins.tags.plugin.TagsPlugin.on_env(env:Environment, *config:MkDocsConfig, **kwargs) -> NonePopulate listings.
method
src.plugins.tags.plugin.TagsPlugin.on_page_context(context:TemplateContext, *page:Page, **kwargs) -> NoneAdd tag references to page context.
method
src.plugins.tags.plugin.TagsPlugin.on_page_markdown(markdown:str, *page:Page, *config:MkDocsConfig, **kwargs) -> strCollect tags and listings from page.
method
src.plugins.tags.plugin.TagsPlugin.on_startup(*command, **kwargs) -> NoneDetermine whether we're serving the site.
class
src.plugins.tags.renderer.RendererA renderer for tags and listings.
method
src.plugins.tags.renderer.Renderer.render(page:Page, name:str, **kwargs) -> strRender a template.
class
src.plugins.tags.structure.listing.ListingA listing of tags.
method
src.plugins.tags.structure.listing.Listing.add(mapping:Mapping, *hidden=True) -> NoneAdd mapping to listing.
class
src.plugins.tags.structure.listing.config.ListingConfigA listing configuration.
class
src.plugins.tags.structure.listing.manager.ListingManagerA listing manager.
method
src.plugins.tags.structure.listing.manager.ListingManager.add(page:Page, markdown:str) -> strAdd page.
method
src.plugins.tags.structure.listing.manager.ListingManager.closest(mapping:Mapping) -> list[Listing]Get listings for the mapping ordered by closeness.
func
src.plugins.tags.structure.listing.manager.toc.find(listing:Listing) -> tuple[AnchorLink | None, int]Find anchor link for the given listing.
class
src.plugins.tags.structure.listing.tree.ListingTreeA listing tree.
class
src.plugins.tags.structure.mapping.MappingA mapping between a page or link and a set of tags.
class
src.plugins.tags.structure.mapping.manager.MappingManagerA mapping manager.
method
src.plugins.tags.structure.mapping.manager.MappingManager.add(page:Page, markdown:str) -> Mapping | NoneAdd page.
method
src.plugins.tags.structure.mapping.manager.MappingManager.get(page:Page) -> Mapping | NoneGet mapping for page, if any.
class
src.plugins.tags.structure.mapping.storage.MappingStorageA mapping storage.
method
src.plugins.tags.structure.mapping.storage.MappingStorage.load(path:str) -> Iterable[Mapping]Load mappings from file.
method
src.plugins.tags.structure.mapping.storage.MappingStorage.save(path:str, mappings:Iterable[Mapping]) -> NoneSave mappings to file.
class
src.plugins.tags.structure.tag.TagA tag.
class
src.plugins.tags.structure.tag.options.TagSetSetting for a set of tags.
method
src.plugins.tags.structure.tag.options.TagSet.run_validation(value:object) -> set[Tag]Validate list of tags.
class
src.plugins.tags.structure.tag.reference.TagReferenceA tag reference.
method
src.plugins.tags.structure.tag.reference.TagReference.url() -> str | NoneReturn the URL of the tag reference.
class
src.utilities.filter.FileFilterA file filter.
class
src.utilities.filter.FilterA filter.
class
src.utilities.filter.config.FilterConfigA filter configuration.
About this data
These signatures were extracted from the public source of squidfunk/mkdocs-material
using Python's ast module. Argument names, default values,
type annotations and return types are taken verbatim from the code.
Implementation bodies are never stored. See
how it works for details.