Markdown Renderer

A lightweight service that renders Markdown to HTML.

Overview

This service supports two rendering modes:

• Route-based rendering (/docs/page -> /docs/page.md or /docs/page/README.md)
• Remote-source rendering (/api/markdown/render?src=https://...)

Endpoints

• GET /healthz Health check.

• GET /api/markdown/render?src=https://... Fetches Markdown from a remote HTTP/HTTPS URL and returns rendered HTML.

• GET /<route-without-extension> Resolves Markdown in order:

  • <route>.md
  • <route>/README.md Returns rendered HTML if found, otherwise a rendered 404 error page.

Rendering Features

• Markdown rendering powered by marked
• Server-side code highlighting via highlight.js
• TOC placeholders: [toc] and <!-- TOC -->
• GitHub-like Markdown style (github-markdown-css)
• HTML error pages for API and route rendering failures

Quick Start Examples

• /test/syntax
• /api/markdown/render?src=https://raw.githubusercontent.com/markedjs/marked/master/README.md