Markdown API

요약

이 API를 사용하여 Markdown 콘텐츠를 HTML로 렌더링합니다. 이 API에 대한 모든 요청은 인증이 필요합니다. 이 기능의 가용성은 기능 플래그로 제어됩니다. Markdown 콘텐츠를 HTML로 렌더링합니다.

히스토리

GitLab 15.3에서 authenticate_markdown_api라는 플래그와 함께 필수 인증 도입. 기본적으로 활성화됨.

이 API를 사용하여 Markdown 콘텐츠를 HTML로 렌더링합니다.

이 API에 대한 모든 요청은 인증이 필요합니다.

Feature flag

이 기능의 가용성은 기능 플래그로 제어됩니다. 자세한 내용은 기록을 참조하세요. 이 기능은 테스트에 사용할 수 있지만 프로덕션 사용에는 준비되지 않았습니다.

Markdown 콘텐츠 렌더링#

Markdown 콘텐츠를 HTML로 렌더링합니다.

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>" }

Markdown API

Tier: Free, Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

원문 보기

번역일: 2026-05-22

요약

히스토리

GitLab 15.3에서 authenticate_markdown_api라는 플래그와 함께 필수 인증 도입. 기본적으로 활성화됨.

이 API를 사용하여 Markdown 콘텐츠를 HTML로 렌더링합니다.

이 API에 대한 모든 요청은 인증이 필요합니다.

Feature flag

Markdown 콘텐츠 렌더링#

Markdown 콘텐츠를 HTML로 렌더링합니다.

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>" }