MeshInspector · oitel · Sep 11, 2026 · Sep 11, 2026 · Sep 11, 2026 · Sep 11, 2026
diff --git a/.github/workflows/update-docs.yml b/.github/workflows/update-docs.yml
@@ -34,6 +34,7 @@ jobs:
         uses: actions/checkout@v7
         with:
           repository: 'MeshInspector/MeshInspector.github.io'
+          ref: 'feature/md'
           path: 'MeshInspector.github.io/'
           token: ${{ secrets.MESHINSPECTOR_BOT_TOKEN }}
           submodules: recursive
@@ -105,4 +106,5 @@ jobs:
           git config user.name "meshinspector-bot"
           git add -A
           git commit --allow-empty -m "Auto update docs" -a
-          git push
+          # feature/md carries the Markdown-era Doxyfile until it merges; master serves the site
+          git push origin HEAD:master
diff --git a/docs/third_party_licenses.md b/docs/third_party_licenses.md
@@ -19,7 +19,7 @@ to** MeshLib's own top-level `LICENSE`, which covers only MeshLib itself.
   the modules that bundle it, the SPDX-ish license id, the upstream, and the **version the
   text was curated against**.
 
-The inclusion list is `doxygen/general_pages/ThirdpartyList.dox`, reconciled against
+The inclusion list is `doxygen/general_pages/ThirdpartyList.md`, reconciled against
 `.gitmodules` and `thirdparty/vcpkg/vcpkg.json`. Build- and test-only submodules (googletest,
 mrbind) are not shipped and are excluded (see `EXCLUDED_SUBMODULES` in the checker).
 

diff --git a/doxygen/common_files/CommonDistributionProperties.dox b/doxygen/common_files/CommonDistributionProperties.dox
diff --git a/doxygen/common_files/CommonDistributionProperties.md b/doxygen/common_files/CommonDistributionProperties.md
@@ -0,0 +1,16 @@
+  - Debug only:
+    - **Debug Configuration: C/C++ → Preprocessor → Preprocessor Definitions**:
+    <br/> Add: `_ITERATOR_DEBUG_LEVEL=0;MR_ITERATOR_DEBUG_LEVEL=0` — for the per-Visual-Studio archives (`MeshLibDistVS19`, `MeshLibDistVS22`, `MeshLibDistVS26`, `MeshLibDistVS26-arm64`).
+    <br/> For the `MeshLibDist-IteratorDebug` archive add `_ITERATOR_DEBUG_LEVEL=2;MR_ITERATOR_DEBUG_LEVEL=2` instead. Both defines must carry the same value: MeshLib stops compilation with `#error _ITERATOR_DEBUG_LEVEL is inconsistent with MeshLib` when they disagree.
+    <br/> Check whether your archive contains `install/include/MRMesh/config_dist.h`. If it does, that header already declares `MR_ITERATOR_DEBUG_LEVEL` for you, so only `_ITERATOR_DEBUG_LEVEL` is yours to set — and `IteratorDebug` then needs no define at all, MSVC's Debug default already being `2`. Setting `MR_ITERATOR_DEBUG_LEVEL` anyway is harmless as long as it matches the archive; a value that contradicts it is rejected at compile time.
+  - For all configurations:
+    - **Solution Platform**:
+    <br/> Set: `x64`
+    - **General Properties -> C++ Language Standard**:
+    <br/> Set: `/std:c++20` or later
+    - **C/C++ → General → Additional Include Directories**:
+    <br/> Add: `C:\meshlib-built\install\include`
+    - **C/C++ → All Options → Additional Options**:
+    <br/> Add: `/bigobj /utf-8`
+    - **Linker → Input → Additional Dependencies**:
+    <br/> Add: `C:\meshlib-built\install\lib\$(Configuration)\*.lib`
diff --git a/doxygen/common_files/JsUsingNote.dox b/doxygen/common_files/JsUsingNote.dox
diff --git a/doxygen/common_files/JsUsingNote.md b/doxygen/common_files/JsUsingNote.md
@@ -0,0 +1,2 @@
+> [!NOTE]
+> The `using` declaration requires Node.js 24+ or a modern browser. On older runtimes, call `.delete()` on each object instead (see [Memory Management](\ref JsMemoryManagement) in the JavaScript Setup Guide).
diff --git a/doxygen/examples/BasedApplication.dox → doxygen/examples/BasedApplication.md b/doxygen/examples/BasedApplication.dox → doxygen/examples/BasedApplication.md
@@ -1,5 +1,4 @@
-/**
- \page BasedApplication Basing your application on MeshLib
+# Basing your application on MeshLib {#BasedApplication}
 
 <div class="tabbed">
 
@@ -9,6 +8,3 @@ First of all you should make `main` function like this
 Then you should make your plugins, to find how have a look at \ref StatePluginsHelp page
 
 </div>
-
- */
-
diff --git a/doxygen/examples/Collision.dox → doxygen/examples/Collision.md b/doxygen/examples/Collision.dox → doxygen/examples/Collision.md
@@ -1,5 +1,4 @@
-/**
- \page ExampleDetectCollisions Detect collisions of two meshes
+# Detect collisions of two meshes {#ExampleDetectCollisions}
 
 Following code presents example of finding collision triangles of two meshes
 
@@ -9,20 +8,18 @@ Following code presents example of finding collision triangles of two meshes
 
 - <b class="tab-title">C++</b>
 \include Collision.dox.cpp
-
+ 
 - <b class="tab-title">Python</b>
 \include Collision.dox.py
-
+ 
 - <b class="tab-title">C</b>
 \include Collision.dox.c
-
+ 
 - <b class="tab-title">C#</b>
 \include Collision.dox.cs
-
+ 
 - <b class="tab-title">JavaScript</b>
 \include Collision.dox.js
-\include{doc} JsUsingNote.dox
+\include{doc} JsUsingNote.md
 
 </div>
-
- */
diff --git a/doxygen/examples/CollisionPrecise.dox → doxygen/examples/CollisionPrecise.md b/doxygen/examples/CollisionPrecise.dox → doxygen/examples/CollisionPrecise.md
@@ -1,5 +1,4 @@
-/**
- \page ExampleDetectCollisionsPrecise Precise detect collisions of two meshes
+# Precise detect collisions of two meshes {#ExampleDetectCollisionsPrecise}
 
 Following code presents example of finding preceise collision triangles and edges of two meshes
 
@@ -9,20 +8,18 @@ Following code presents example of finding preceise collision triangles and edge
 
 - <b class="tab-title">C++</b>
 \include CollisionPrecise.dox.cpp
-
+ 
 - <b class="tab-title">Python</b>
 \include CollisionPrecise.dox.py
-
+ 
 - <b class="tab-title">C</b>
 \include CollisionPrecise.dox.c
-
+ 
 - <b class="tab-title">C#</b>
 \include CollisionPrecise.dox.cs
-
+ 
 - <b class="tab-title">JavaScript</b>
 \include CollisionPrecise.dox.js
-\include{doc} JsUsingNote.dox
+\include{doc} JsUsingNote.md
 
 </div>
-
- */
diff --git a/doxygen/examples/CollisionSelf.dox → doxygen/examples/CollisionSelf.md b/doxygen/examples/CollisionSelf.dox → doxygen/examples/CollisionSelf.md
@@ -1,26 +1,23 @@
-/**
- \page ExampleDetectSelfIntersections Find self-intersecting triangles of single mesh
+# Find self-intersecting triangles of single mesh {#ExampleDetectSelfIntersections}
 
 Following code presents example of finding self-intersecting triangles of single mesh
 
 <div class="tabbed">
 
 - <b class="tab-title">C++</b>
 \include CollisionSelf.dox.cpp
-
+ 
 - <b class="tab-title">Python</b>
 \include CollisionSelf.dox.py
-
+ 
 - <b class="tab-title">C</b>
 \include CollisionSelf.dox.c
-
+ 
 - <b class="tab-title">C#</b>
 \include CollisionSelf.dox.cs
-
+ 
 - <b class="tab-title">JavaScript</b>
 \include CollisionSelf.dox.js
-\include{doc} JsUsingNote.dox
+\include{doc} JsUsingNote.md
 
 </div>
-
- */
diff --git a/doxygen/examples/CudaOffset.dox → doxygen/examples/CudaOffset.md b/doxygen/examples/CudaOffset.dox → doxygen/examples/CudaOffset.md
@@ -1,14 +1,11 @@
-/**
- \page ExampleCudaOffset Offset with Cuda
+# Offset with Cuda {#ExampleCudaOffset}
 
 Example of Python usage of Cuda to offset mesh
 
 <div class="tabbed">
-
+ 
 - <b class="tab-title">Python</b>
 You can use CUDA-driven offset for faster healing mesh with holes, example healing script can be found [here](https://github.com/MeshInspector/MeshLib/blob/master/python_scripts/healer.py)
 \include CudaOffset.dox.py
 
 </div>
-
- */
diff --git a/.../examples/ExampleContourTriangulation.dox → ...n/examples/ExampleContourTriangulation.md b/.../examples/ExampleContourTriangulation.dox → ...n/examples/ExampleContourTriangulation.md
@@ -1,20 +1,16 @@
-/**
- \page ExampleContourTriangulation Contour Triangulation Example
+# Contour Triangulation Example {#ExampleContourTriangulation}
 
 Example of generating a triangulation from a contour.
 
 <div class="tabbed">
-
+ 
 - <b class="tab-title">C++</b>
 \include ContourTriangulation.dox.cpp
-
+ 
 - <b class="tab-title">Python</b>
 \include ContourTriangulation.dox.py
-
+ 
 - <b class="tab-title">C</b>
 \include ContourTriangulation.dox.c
 
 </div>
-
- */
-
diff --git a/doxygen/examples/ExampleFusion.dox → doxygen/examples/ExampleFusion.md b/doxygen/examples/ExampleFusion.dox → doxygen/examples/ExampleFusion.md
@@ -1,24 +1,20 @@
-/**
- \page ExampleFusion Fusion Example
+# Fusion Example {#ExampleFusion}
 
 Example of Fusion.
 
 <div class="tabbed">
-
+ 
 - <b class="tab-title">C++</b>
 \include Fusion.dox.cpp
-
+ 
 - <b class="tab-title">Python</b>
 \include Fusion.dox.py
-
+ 
 - <b class="tab-title">C</b>
 \include Fusion.dox.c
-
+ 
 - <b class="tab-title">JavaScript</b>
 \include Fusion.dox.js
-\include{doc} JsUsingNote.dox
+\include{doc} JsUsingNote.md
 
 </div>
-
- */
-
diff --git a/doxygen/examples/ExamplePointsToMesh.dox → doxygen/examples/ExamplePointsToMesh.md b/doxygen/examples/ExamplePointsToMesh.dox → doxygen/examples/ExamplePointsToMesh.md
@@ -1,24 +1,20 @@
-/**
- \page ExamplePointsToMesh Points to Mesh Example
+# Points to Mesh Example {#ExamplePointsToMesh}
 
 Example of generating a triangulation from a pointcloud.
 
 <div class="tabbed">
-
+ 
 - <b class="tab-title">C++</b>
 \include PointsToMesh.dox.cpp
-
+ 
 - <b class="tab-title">Python</b>
 \include PointsToMesh.dox.py
-
+ 
 - <b class="tab-title">C</b>
 \include PointsToMesh.dox.c
-
+ 
 - <b class="tab-title">JavaScript</b>
 \include PointsToMesh.dox.js
-\include{doc} JsUsingNote.dox
+\include{doc} JsUsingNote.md
 
 </div>
-
- */
-
diff --git a/.../examples/ExampleTerrainTriangulation.dox → ...n/examples/ExampleTerrainTriangulation.md b/.../examples/ExampleTerrainTriangulation.dox → ...n/examples/ExampleTerrainTriangulation.md
@@ -1,20 +1,16 @@
-/**
- \page ExampleTerrainTriangulation Terrain Triangulation Example
+# Terrain Triangulation Example {#ExampleTerrainTriangulation}
 
 Example of generating a triangulation from a terrain scan (specific pointcloud).
 
 <div class="tabbed">
-
+ 
 - <b class="tab-title">C++</b>
 \include TerrainTriangulation.dox.cpp
-
+ 
 - <b class="tab-title">Python</b>
 \include TerrainTriangulation.dox.py
-
+ 
 - <b class="tab-title">C</b>
 \include TerrainTriangulation.dox.c
 
 </div>
-
- */
-
diff --git a/doxygen/examples/Examples.dox → doxygen/examples/Examples.md b/doxygen/examples/Examples.dox → doxygen/examples/Examples.md
@@ -1,18 +1,16 @@
-/**
-
-\page Examples MeshLib Code Samples
+# MeshLib Code Samples {#Examples}
 
 # Code Samples for MeshLib
 
 This page contains some examples of using MeshLib
 
 A number of these operations also run interactively in the browser: see the [live demo](https://demo.meshlib.io/).
 
-\subsection CppApplication C++ Application Based on MeshLib
+## C++ Application Based on MeshLib {#CppApplication}
 
  - \ref BasedApplication
 
-\subsection GeneralExamples General Samples
+## General Samples {#GeneralExamples}
 
  - \ref ExampleMeshLoadSave
  - \ref ExampleMeshExport
@@ -40,13 +38,13 @@ A number of these operations also run interactively in the browser: see the [liv
  - \ref ExampleFusion
  - \ref ExampleMeshFromText
 
-\subsection Collisions Collisions
+## Collisions {#Collisions}
 
  - \ref ExampleDetectCollisions
  - \ref ExampleDetectCollisionsPrecise
  - \ref ExampleDetectSelfIntersections
 
-\subsection PythonSpecificExamples Python Specific Samples
+## Python Specific Samples {#PythonSpecificExamples}
 
  - \ref ExampleViewer
  - \ref ExampleViewerVolumeRender
@@ -55,5 +53,3 @@ A number of these operations also run interactively in the browser: see the [liv
  - \ref ExampleNumpyTriangulation
  - \ref ExampleCudaOffset
  - \ref ExampleDicomFiles
-
-*/
diff --git a/doxygen/examples/FreeFormDeformation.dox → doxygen/examples/FreeFormDeformation.md b/doxygen/examples/FreeFormDeformation.dox → doxygen/examples/FreeFormDeformation.md
@@ -1,30 +1,28 @@
-/**
- \page ExampleFreeForm Free Form Deformation Example
+# Free Form Deformation Example {#ExampleFreeForm}
 
 Example of using Free Form deformation of the mesh
 
 ▶ [See it live in the browser](https://demo.meshlib.io/#deform)
 
 <div class="tabbed">
-
+ 
 - <b class="tab-title">C++</b>
 \include FreeFormDeformation.dox.cpp
-
+ 
 - <b class="tab-title">Python</b>
-\note Python API version 3 and later
-
+> [!NOTE]
+> Python API version 3 and later
+
 \include FreeFormDeformation.dox.py
-
+ 
 - <b class="tab-title">C</b>
 \include FreeFormDeformation.dox.c
-
+ 
 - <b class="tab-title">C#</b>
 \include FreeFormDeformation.dox.cs
-
+ 
 - <b class="tab-title">JavaScript</b>
 \include FreeFormDeformation.dox.js
-\include{doc} JsUsingNote.dox
+\include{doc} JsUsingNote.md
 
 </div>
-
- */
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		> [!NOTE]
		> The `using` declaration requires Node.js 24+ or a modern browser. On older runtimes, call `.delete()` on each object instead (see [Memory Management](\ref JsMemoryManagement) in the JavaScript Setup Guide).