Markdown API

プラン: Free、Premium、Ultimate
提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

このAPIを使用して、MarkdownコンテンツをHTMLとしてレンダリングします。

このAPIへのすべてのリクエストは、認証される必要があります。

この機能の利用可否は、機能フラグによって制御されます。詳細については、履歴を参照してください。この機能はテストには利用できますが、本番環境での使用には適していません。

Markdownコンテンツをレンダリングする

MarkdownコンテンツをHTMLとしてレンダリングします。

POST /markdown

属性	型	必須	説明
`text`	文字列	はい	レンダリングするMarkdownテキスト
`gfm`	ブール値	いいえ	GitLab Flavored Markdownを使用してテキストをレンダリングします。デフォルトは`false`です。
`project`	文字列	いいえ	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>" }