Skip to content
Try Gitea Cloud ☁️ for 30 days → Accelerate your Development & Deploys!
This is the documentation of the next version, still under development. See the latest release.

Render a markdown document as HTML

POST
/markdown
curl --request POST \
--url https://gitea.com/api/v1/markdown \
--header 'Authorization: Basic <credentials>' \
--header 'Content-Type: application/json' \
--data '{ "Context": "example", "Mode": "example", "Text": "example", "Wiki": true }'
Media typeapplication/json

MarkdownOption markdown options

object
Context

URL path for rendering issue, media and file links Expected format: /subpath/{user}/{repo}/src/{branch, commit, tag}/{identifier/path}/{file/dir}

string
Mode

Mode to render (markdown, comment, wiki, file)

string
Text

Text markdown to render

string
Wiki

Is it a wiki page? (use mode=wiki instead)

boolean
Examplegenerated
{
"Context": "example",
"Mode": "example",
"Text": "example",
"Wiki": true
}

MarkdownRender is a rendered markdown document

Media typeapplication/json
string
Examplegenerated
example

APIValidationError is error format response related to input validation

message
string
url
string