Markdown API

将 Markdown 内容转换为 HTML。

仅在 APIv4 中可用。

需要身份验证

引入于极狐GitLab 15.3。功能标志名为 authenticate_markdown_api。默认启用。

FLAG: 在私有化部署的极狐GitLab 上,默认情况下启用此功能并且需要身份验证。 要删除身份验证要求,管理员可以禁用名为 authenticate_markdown_api功能标志。 在 JihuLab.com 上,此功能可用。

所有对 Markdown API 的 API 调用都必须经过身份验证

渲染任意 Markdown 文档。

POST /markdown
参数 类型 是否必需 描述
text string yes 渲染的 Markdown 文本
gfm boolean no 使用极狐GitLab Flavored Markdown 的渲染文本。默认为 false
project string no 使用极狐 GitLab Flavored Markdown 创建引用时,将 project 用作上下文
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
  --header "Content-Type:application/json" \
  --data '{"text":"Hello world! :tada:", "gfm":true, "project":"group_example/project_example"}' "https://gitlab.example.com/api/v4/markdown"

响应示例:

{ "html": "<p dir=\"auto\">Hello world! <gl-emoji title=\"party popper\" data-name=\"tada\" data-unicode-version=\"6.0\">🎉</gl-emoji></p>" }