diff --git a/docs/mkdocs/docs/api/macros/json_diagnostic_positions.md b/docs/mkdocs/docs/api/macros/json_diagnostic_positions.md
index a33b3e93f1..18d0db9933 100644
--- a/docs/mkdocs/docs/api/macros/json_diagnostic_positions.md
+++ b/docs/mkdocs/docs/api/macros/json_diagnostic_positions.md
@@ -78,6 +78,7 @@ When the macro is not defined, the library will define it to its default value.
     ```
     --8<-- "examples/diagnostic_positions.output"
     ```
+
     The output shows the start/end positions of all the objects and fields in the JSON string.
 
 ??? example "Example 2: using only diagnostic positions in exceptions"
@@ -90,7 +91,8 @@ When the macro is not defined, the library will define it to its default value.
 
     ```
     --8<-- "examples/diagnostic_positions_exception.output"
-    ```    
+    ```
+
         The output shows the exception with start/end positions only.
 
 ??? example "Example 3: using extended diagnostics with positions enabled in exceptions"
@@ -104,6 +106,7 @@ When the macro is not defined, the library will define it to its default value.
     ```
     --8<-- "examples/diagnostics_extended_positions.output"
     ```
+    
         The output shows the exception with diagnostic path info and start/end positions.
 ## Version history
 
diff --git a/docs/examples/diagnostic_positions_exception.cpp b/docs/mkdocs/docs/examples/diagnostic_positions_exception.cpp
similarity index 99%
rename from docs/examples/diagnostic_positions_exception.cpp
rename to docs/mkdocs/docs/examples/diagnostic_positions_exception.cpp
index f50311a471..ea4c413930 100644
--- a/docs/examples/diagnostic_positions_exception.cpp
+++ b/docs/mkdocs/docs/examples/diagnostic_positions_exception.cpp
@@ -28,4 +28,3 @@ int main()
         std::cout << e.what() << '\n';
     }
 }
-
diff --git a/docs/examples/diagnostic_positions_exception.output b/docs/mkdocs/docs/examples/diagnostic_positions_exception.output
similarity index 100%
rename from docs/examples/diagnostic_positions_exception.output
rename to docs/mkdocs/docs/examples/diagnostic_positions_exception.output
diff --git a/docs/examples/diagnostics_extended_positions.cpp b/docs/mkdocs/docs/examples/diagnostics_extended_positions.cpp
similarity index 100%
rename from docs/examples/diagnostics_extended_positions.cpp
rename to docs/mkdocs/docs/examples/diagnostics_extended_positions.cpp
diff --git a/docs/examples/diagnostics_extended_positions.output b/docs/mkdocs/docs/examples/diagnostics_extended_positions.output
similarity index 100%
rename from docs/examples/diagnostics_extended_positions.output
rename to docs/mkdocs/docs/examples/diagnostics_extended_positions.output