diff --git a/apps/md2html/config.json b/apps/md2html/config.json
new file mode 100644
index 0000000..e5c8085
--- /dev/null
+++ b/apps/md2html/config.json
@@ -0,0 +1,19 @@
+{
+  "name": "Markdown Converter",
+  "id": "md2html",
+  "available": true,
+  "short_desc": "Convert Markdown to styled HTML or PDF with TOC and Mermaid diagrams",
+  "author": "alexz",
+  "port": 8340,
+  "categories": ["utilities", "development"],
+  "description": "A web-based Markdown converter that produces beautifully styled HTML documents with sidebar table of contents, Mermaid diagram rendering, and PDF export via headless Chromium. Supports drag-and-drop file upload, live preview, and downloadable output.",
+  "tipi_version": 1,
+  "version": "1.0.0",
+  "source": "https://git.alexzaw.dev/alexz/md2html",
+  "website": "https://git.alexzaw.dev/alexz/md2html",
+  "exposable": true,
+  "dynamic_config": true,
+  "no_gui": false,
+  "form_fields": [],
+  "supported_architectures": ["arm64", "amd64"]
+}
diff --git a/apps/md2html/docker-compose.json b/apps/md2html/docker-compose.json
new file mode 100644
index 0000000..fc45ac5
--- /dev/null
+++ b/apps/md2html/docker-compose.json
@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 2,
+  "services": [
+    {
+      "name": "md2html",
+      "image": "md2html:latest",
+      "isMain": true,
+      "internalPort": 3000,
+      "environment": {
+        "PORT": "3000",
+        "CHROME_PATH": "/usr/bin/chromium"
+      }
+    }
+  ]
+}
diff --git a/apps/md2html/metadata/description.md b/apps/md2html/metadata/description.md
new file mode 100644
index 0000000..54a3a2b
--- /dev/null
+++ b/apps/md2html/metadata/description.md
@@ -0,0 +1,12 @@
+# Markdown Converter
+
+Convert Markdown files to beautifully styled HTML or PDF documents.
+
+## Features
+
+- **Sidebar TOC** — Auto-generated table of contents with scroll-tracking highlights
+- **Mermaid Diagrams** — Renders flowcharts, sequence diagrams, and more
+- **PDF Export** — Server-side PDF generation via headless Chromium
+- **Drag & Drop** — Upload .md files or paste markdown directly
+- **Live Preview** — Preview the styled HTML in a new tab before downloading
+- **Responsive** — Mobile-friendly layout with collapsible sidebar