---
title: Workshop Markdown Converter Guide
content_type: guide
renderer_version: v1
generated_at: 2026-09-26T00:28:22.217Z
---

# Workshop Markdown Converter

Start here: `/wiki/articles`

## Core Endpoints

- `GET /healthz`
- `GET /wiki/articles`
- `GET /wiki/articles/:slug`
- `GET /wiki/categories`
- `GET /wiki/categories/:slug`
- `.md` suffixes remain supported as explicit Markdown aliases

## Quick Usage

```bash
# Root guide
curl https://md.wrightkit.dev/

# Article index as markdown
curl https://md.wrightkit.dev/wiki/articles

# Workshop documentation category
curl https://md.wrightkit.dev/wiki/categories/actions

# Exact document
curl https://md.wrightkit.dev/wiki/articles/hero-color-reference-table
```

## Behavior Notes

- Markdown responses use `text/markdown; charset=utf-8`.
- Route rules:
  - Article, index, and category routes without `.md` return Markdown by default.
  - Paths ending in `.md` remain supported as explicit Markdown aliases.
- Errors are returned as markdown pages:
  - `404` for missing articles.
  - `5xx` markdown errors for upstream/internal failures.
- Article body conversion uses minimal cleaning only.
- Existing markdown structures (headings, code blocks, tables, lists) are preserved.
- `<style>` and `<script>` tags are removed from article content.
- Cache and metadata headers are present, including `Cache-Control`, `ETag`, `Vary: Accept`, and `x-markdown-tokens`.