diff --git a/pkgs/by-name/ni/nixos-render-docs/src/nixos_render_docs/commonmark.py b/pkgs/by-name/ni/nixos-render-docs/src/nixos_render_docs/commonmark.py
index 3831ae3d344d..05dc5b33a774 100644
--- a/pkgs/by-name/ni/nixos-render-docs/src/nixos_render_docs/commonmark.py
+++ b/pkgs/by-name/ni/nixos-render-docs/src/nixos_render_docs/commonmark.py
@@ -22,6 +22,7 @@ class CommonMarkRenderer(Renderer):
     __output__ = "commonmark"
 
     _admonition_style: AdmonitionStyle
+    _div_fence_sizes: list[int]
     _parstack: list[Par]
     _link_stack: list[str]
     _list_stack: list[List]
@@ -29,6 +30,7 @@ class CommonMarkRenderer(Renderer):
     def __init__(self, manpage_urls: Mapping[str, str], admonition_style: AdmonitionStyle = AdmonitionStyle.PLAIN):
         super().__init__(manpage_urls)
         self._admonition_style = admonition_style
+        self._div_fence_sizes = [ ]
         self._parstack = [ Par("") ]
         self._link_stack = []
         self._list_stack = []
@@ -46,6 +48,24 @@ class CommonMarkRenderer(Renderer):
         self._parstack[-1].continuing = True
         return result
 
+    def _fenced_div_open(self, classes: Sequence[str] = ()) -> str:
+        fence_size = (
+            self._div_fence_sizes[-1] + 1
+            if self._div_fence_sizes
+            else 3
+        )
+        fence = ":" * fence_size
+        class_refs = [f".{c}" for c in classes]
+        annotation = (" {" + " ".join(class_refs) + "}") if classes else ""
+        pbreak = self._maybe_parbreak()
+        self._div_fence_sizes.append(fence_size)
+        return f"{pbreak}{fence}{annotation}"
+    def _fenced_div_close(self) -> str:
+        fence_size = self._div_fence_sizes.pop()
+        fence = ":" * fence_size
+        pbreak = self._maybe_parbreak()
+        return f"{pbreak}{fence}"
+
     def _admonition_open(self, kind: str) -> str:
         match self._admonition_style:
             case AdmonitionStyle.PLAIN:
@@ -57,6 +77,8 @@ class CommonMarkRenderer(Renderer):
                 lbreak = self._break()
                 self._enter_block("> ")
                 return f"{pbreak}> [!{kind}]{lbreak}> "
+            case AdmonitionStyle.PANDOC:
+                return self._fenced_div_open(classes=[kind.lower()])
 
     def _admonition_close(self) -> str:
         match self._admonition_style:
@@ -64,6 +86,8 @@ class CommonMarkRenderer(Renderer):
                 self._leave_block()
             case AdmonitionStyle.GFM:
                 self._leave_block()
+            case AdmonitionStyle.PANDOC:
+                return self._fenced_div_close()
         return ""
 
     def _indent_raw(self, s: str) -> str:
diff --git a/pkgs/by-name/ni/nixos-render-docs/src/nixos_render_docs/types.py b/pkgs/by-name/ni/nixos-render-docs/src/nixos_render_docs/types.py
index 4e8bcf674bc7..64ac3b02dd89 100644
--- a/pkgs/by-name/ni/nixos-render-docs/src/nixos_render_docs/types.py
+++ b/pkgs/by-name/ni/nixos-render-docs/src/nixos_render_docs/types.py
@@ -20,4 +20,5 @@ class AnchorStyle(Enum):
 
 class AdmonitionStyle(Enum):
     PLAIN = "plain"
+    PANDOC = "pandoc"
     GFM = "gfm"
diff --git a/pkgs/by-name/ni/nixos-render-docs/src/tests/sample_options_admonition_pandoc.md b/pkgs/by-name/ni/nixos-render-docs/src/tests/sample_options_admonition_pandoc.md
new file mode 100644
index 000000000000..80a853f89a67
--- /dev/null
+++ b/pkgs/by-name/ni/nixos-render-docs/src/tests/sample_options_admonition_pandoc.md
@@ -0,0 +1,19 @@
+## services\.frobnicator\.types\.\<name>\.enable
+
+Whether to enable the frobnication of this (` <name> `) type\.
+
+::: {.important}
+
+Admonition\.
+
+:::
+
+
+
+*Type:*
+boolean
+
+*Declared by:*
+ - [\<nixpkgs/nixos/modules/services/frobnicator\.nix>](https://github.com/NixOS/nixpkgs/blob/master/nixos/modules/services/frobnicator.nix)
+
+
diff --git a/pkgs/by-name/ni/nixos-render-docs/src/tests/test_commonmark.py b/pkgs/by-name/ni/nixos-render-docs/src/tests/test_commonmark.py
index c1c713f1f416..17379621b4fe 100644
--- a/pkgs/by-name/ni/nixos-render-docs/src/tests/test_commonmark.py
+++ b/pkgs/by-name/ni/nixos-render-docs/src/tests/test_commonmark.py
@@ -77,6 +77,47 @@ def test_indented_fence() -> None:
 > > nested GFM\
 """,
         ),
+        (
+            nrd.types.AdmonitionStyle.PANDOC,
+            """\
+::: {.warning}
+
+foo
+
+:::: {.note}
+
+nested
+
+::::
+
+:::
+
+::: {.important}
+
+nested GFM
+
+:::
+
+:::
+
+::: {.caution}
+
+GFM caution
+
+:::: {.important}
+
+nested fenced
+
+::::
+
+:::: {.note}
+
+nested GFM
+
+::::
+
+:::""",
+        ),
     ],
 )
 def test_admonition_styles(
diff --git a/pkgs/by-name/ni/nixos-render-docs/src/tests/test_options.py b/pkgs/by-name/ni/nixos-render-docs/src/tests/test_options.py
index 3e774b1b020b..d33259587652 100644
--- a/pkgs/by-name/ni/nixos-render-docs/src/tests/test_options.py
+++ b/pkgs/by-name/ni/nixos-render-docs/src/tests/test_options.py
@@ -47,6 +47,8 @@ def test_options_commonmark_legacy_anchors() -> None:
          "tests/sample_options_admonition_plain.md"),
         (nixos_render_docs.types.AdmonitionStyle.GFM,
          "tests/sample_options_admonition_gfm.md"),
+        (nixos_render_docs.types.AdmonitionStyle.PANDOC,
+         "tests/sample_options_admonition_pandoc.md"),
     ],
 )
 def test_options_commonmark_admonition_style(style, expected_file):