From cb17bd27c0dd90758163a291577d7f4b32b2d454 Mon Sep 17 00:00:00 2001 From: Sujay Patil Date: Fri, 3 Apr 2026 12:09:41 -0700 Subject: [PATCH 1/2] add list of mkdocs/material extensions --- template/mkdocs.yml.jinja | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/template/mkdocs.yml.jinja b/template/mkdocs.yml.jinja index 3d1403f..9be4925 100644 --- a/template/mkdocs.yml.jinja +++ b/template/mkdocs.yml.jinja @@ -40,6 +40,11 @@ markdown_extensions: # disable code highlighting to display diagrams format: !!python/name:pymdownx.superfences.fence_code_format class: mermaid + - admonition + - tables + - pymdownx.magiclink + - attr_list + - md_in_html # TODO rebuild docs on schema change (https://github.com/linkml/linkml-project-copier/issues/39) # - gen-files: From 3e5d6b31879b65abe5c1ccca0c8bffb47bb1f009 Mon Sep 17 00:00:00 2001 From: Sujay Patil Date: Mon, 6 Apr 2026 11:03:35 -0700 Subject: [PATCH 2/2] comments about enabled mkdocs extensions --- template/mkdocs.yml.jinja | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/template/mkdocs.yml.jinja b/template/mkdocs.yml.jinja index 9be4925..c9fd797 100644 --- a/template/mkdocs.yml.jinja +++ b/template/mkdocs.yml.jinja @@ -40,10 +40,20 @@ markdown_extensions: # disable code highlighting to display diagrams format: !!python/name:pymdownx.superfences.fence_code_format class: mermaid + # https://facelessuser.github.io/pymdown-extensions/extensions/magiclink/ + # auto-link HTML, FTP, and email links + - pymdownx.magiclink + # https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#admonition + # support for call-outs - admonition + # https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#tables + # create tables - tables - - pymdownx.magiclink + # https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#attribute-lists + # enables use of HTML attributes and CSS classes to applicable elements - attr_list + # https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#markdown-in-html + # write markdown inside of HTML - md_in_html # TODO rebuild docs on schema change (https://github.com/linkml/linkml-project-copier/issues/39)