Discourse는 이제 네이티브 마크다운(Markdown) 엔드포인트를 지원하여, AI 도구 및 기타 클라이언트가 전체 HTML 페이지를 파싱하지 않고도 포럼 콘텐츠를 더 쉽게 읽을 수 있도록 했습니다.
이 기능은 Upcoming Changes 시스템을 통해 모든 호스팅 사이트에서 기본적으로 활성화됩니다. 옵트아웃을 원하는 관리자는 enable_markdown_endpoints 사이트 설정을 비활성화하여 이를 수행할 수 있습니다.
원본 Discourse to Markdown 플러그인을 개발한 @benword에게 감사드립니다. 이 플러그인은 Discourse 코어에 포함된 이 기능의 선구자 역할을 했습니다.
마크다운 출력은 게시글의 렌더링된(“cooked”) HTML에서 생성되며, 확장된 링크와 처리된 포맷을 포함하여 독자가 보는 콘텐츠를 보존합니다. 인용, 원박스(onebox), 코드 블록, 투표, 접을 수 있는 섹션 등 Discourse 고유 요소는 마크다운으로 다시 변환됩니다. 주제 응답에는 메타데이터와 페이지네이션 링크가 포함되며, 변환된 게시글 본문은 콘텐츠 다이제스트를 사용하여 캐시되므로 편집 시 새로운 출력이 생성됩니다.
클라이언트는 .md URL을 통해 명시적으로 마크다운을 요청하거나 Accept: text/markdown 헤더를 전송할 수 있습니다. 협상(negotiation)은 품질 값(Quality values)을 존중하며, HTML 및 JSON보다 마크다운이 선호될 때 마크다운을 선택합니다. 명시적인 .md 요청은 해당 포맷을 유지합니다. 지원되는 HTML 페이지는 HTTP Link 헤더와 <link rel="alternate"> 요소를 통해 해당 마크다운 버전을 광고합니다.