docs(shortcodes): Add example repository badge

docs/conventions.md

@@ -91,3 +91,7 @@ Besides plugins, there are some utilities that build on top of MkDocs in order
 to provide extended functionality, like for example support for versioning.
 
   [Insiders]: insiders/index.md
+
+### <!-- md:examplerepo --> – Example Repository
+
+This symbol indicates that an example repository is available on GitHub. 

docs/setup/setting-up-a-blog.md

@@ -22,6 +22,7 @@ __Check out our [blog], which is created with the new [built-in blog plugin]!__
 <!-- md:version 9.2.0 -->
 <!-- md:plugin -->
 <!-- md:flag experimental -->
+<!-- md:examplerepo create-blog -->
 
 The built-in blog plugin adds support for building a blog from a folder of
 posts, which are annotated with dates and other structured data. First, add the

docs/setup/setting-up-social-cards.md

@@ -37,6 +37,7 @@ Social card of our [formatting] reference
 <!-- md:version 8.5.0 -->
 <!-- md:plugin -->
 <!-- md:flag experimental -->
+<!-- md:examplerepo create-social-card -->
 
 The built-in social plugin automatically generate a custom preview image for
 each page. Install all [dependencies for image processing] and add the

docs/setup/setting-up-versioning.md

@@ -13,6 +13,7 @@ documentation remain untouched.
 
 <!-- md:version 7.0.0 -->
 <!-- md:utility [mike] -->
+<!-- md:examplerepo example-versioning -->
 
 [mike] makes it easy to deploy multiple versions of your project documentation.
 It integrates natively with Material for MkDocs and can be enabled via

material/overrides/hooks/shortcodes.py

@@ -46,6 +46,7 @@ def replace(match: Match):
                 return _badge_for_version_insiders(args, page, files)
             else:
                 return _badge_for_version(args, page, files)
+        elif type == "examplerepo": return _badge_for_example_repo(args, page, files)
         elif type == "sponsors":     return _badge_for_sponsors(page, files)
         elif type == "flag":         return flag(args, page, files)
         elif type == "option":       return option(args)
@@ -142,6 +143,17 @@ def _badge_for_version(text: str, page: Page, files: Files):
         text = f"[{text}]({_resolve_path(path, page, files)})" if spec else ""
     )
 
+# Create badge for example repositories
+def _badge_for_example_repo(args: str, page: Page, files: Files):
+    repo_name = args.strip()  
+    icon_url = _resolve_path("conventions.md#experimental", page, files)  
+    text_href = f"https://github.com/mkdocs-material/{repo_name}" 
+    icon = "material-github"  
+    return _badge(
+        icon=f"[:{icon}:]({icon_url} 'Example Repository')", 
+        text=f"[{repo_name}]({text_href})" 
+    )
+
 # Create badge for version of Insiders
 def _badge_for_version_insiders(text: str, page: Page, files: Files):
     spec = text.replace("insiders-", "")