---
title: "Render a markup document as HTML"
method: POST
path: "/markup"
tags: ["miscellaneous"]
---

# Render a markup document as HTML

`POST /markup`

## Request body

- MarkupOption — MarkupOption markup options
  - `Context` string — URL path for rendering issue, media and file links Expected format: /subpath/{user}/{repo}/src/{branch, commit, tag}/{identifier/path}/{file/dir}
  - `FilePath` string — File path for detecting extension in file mode
  - `Mode` string — Mode to render (markdown, comment, wiki, file)
  - `Text` string — Text markup to render
  - `Wiki` boolean — Is it a wiki page? (use mode=wiki instead)

## Response `200`

MarkupRender is a rendered markup document

- string

## Other responses

- `422` — APIValidationError is error format response related to input validation

---

[API](https://skmtc.net/gitea/apis/gitea-api.md) · [All operations](https://skmtc.net/gitea/apis/gitea-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitea/gitea-api/versions/350de506cefa/schema)