Renderer
A lightweight service for rendering Markdown / Text / JSON into HTML viewer pages.
What It Supports
- Route-based Markdown rendering (internal use only)
/docs/page->/docs/page.mdor/docs/page/README.md - API-based rendering from remote sources (
src=<encodedSrc>) - API-based rendering from request body (
POST)
API Endpoints
Markdown
GET /api/markdown/render?src=<encodedSrc>POST /api/markdown/render
Text
GET /api/text/render?src=<encodedSrc>&title=...POST /api/text/render?title=...
JSON
GET /api/json/render?src=<encodedSrc>&title=...POST /api/json/render?title=...
Source Param Encoding
GET endpoints that use src require encoded input.
base64Encode(rawUrl)urlEncode(base64Payload)
Server parse flow:
urlDecode(src)base64Decode(payload)- validate
http/httpsURL
Example helper:
function encodeSrc(rawUrl: string): string {
const bytes = new TextEncoder().encode(rawUrl);
let binary = '';
for (const byte of bytes) binary += String.fromCharCode(byte);
return encodeURIComponent(btoa(binary));
}Viewer Features
- Markdown:
marked+highlight.js+katex - Text: plain text viewer with safe escaping and auto-linking
- JSON:
- node expand/collapse
- expand all / collapse all
- copy JSON / copy minified JSON
- in-page search (
Ctrl/Cmd + F) - large JSON default-depth protection
- collapsed-state persistence (session-level)
Quick Links
| Example | Description |
|---|---|
/test/syntax |
Markdown syntax playground |
/test/error |
Route 404 page demo |
| Markdown from GitHub Raw | Markdown remote render |
| Text from GitHub Raw | Text remote render |
| JSON from GitHub Raw | JSON remote render |
Internal Test Links
Markdown
| Endpoint | Purpose |
|---|---|
/api/mardown/render/error |
Markdown error page test |
/api/mardown/render/client |
Markdown client-side viewer test |
Text
| Endpoint | Purpose |
|---|---|
/api/text/render/error |
Text error page test |
/api/text/render/test |
Text viewer demo page |
JSON
| Endpoint | Purpose |
|---|---|
/api/json/render/error |
JSON error page test |
/api/json/render/test |
JSON complex demo page |