Convert GitHub admonitions to just-the-docs syntax

Author: keveleigh

.github/workflows/pages.yml

@@ -9,7 +9,7 @@ name: Deploy Docs site to Pages
 on:
   push:
     branches: ["add-gh-pages"]
-    paths: ["docs/**","**/README.md","**/CHANGELOG.md"]
+    paths: ["docs/**","**/README.md","**/CHANGELOG.md","Pipelines/Scripts/prepare-pages.ps1"]
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:

Pipelines/Scripts/prepare-pages.ps1

@@ -33,7 +33,9 @@ parent: Packages
 
 
 "@
-    Add-Content -Path "./$packageName.md" -Value (Get-Content -Path (Join-Path $packagePath "README.md"))
+    $readmeContent = (Get-Content -Path (Join-Path $packagePath "README.md"))
+    $readmeContent = $readmeContent -replace "> \[!(\w+)\]", { "{: .$("$($_.Groups[1])".ToLower()) }" } # Convert GitHub admonitions to just-the-docs syntax
+    Add-Content -Path "./$packageName.md" -Value $readmeContent
 
     # Create CHANGELOG, add front matter, and copy content
     New-Item -Path "./$packageName.CHANGELOG.md" -Value @"