Markdown Renderer
A lightweight service that renders Markdown to HTML.
Overview
This service supports two rendering modes:
- Route-based rendering (
/docs/page->/docs/page.mdor/docs/page/README.md) - Remote-source rendering (
/api/markdown/render?src=https://...)
Endpoints
GET /healthzHealth 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.mdReturns rendered HTML if found, otherwise a rendered404error 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