레드마인 위키 페이지 내 마크다운으로 작성한 각주 추가 시 인식이 제대로 안되는 문제 Not recognized issues of footnote by markdown in Redmine

1. 증상

레드마인 위키 페이지에 마크다운(Markdown) 규칙에 따라 각주를 추가했음에도 정상적으로 각주가 인식되지 않는 문제가 발생합니다.

레드마인 설정에서 본문 형식이 마크다운(Markdown)으로 설정되지 않았거나, 레드마인 자체에서 마크다운 언어를 지원하지 않아 플러그인 설치가 필요한 경우가 있습니다.

redmine_wiki_extensions와 같이 레드마인 본문 내에서 마크다운을 인식하도록 **플러그인(extensions)**을 설치합니다.

마크다운은 레드마인 버전에 따라 자동으로 인식되기도 하지만, 일부 버전에서는 제대로 인식되지 않는 문제가 있습니다. 저는 레드마인 5.1.1 버전을 사용 중이었고, 해당 문제가 발생하여 플러그인을 설치했습니다.

레드마인 설정 중 아래 경로에서 마크다운 설정이 정상적으로 되어 있는지 확인합니다.

'관리 > 설정 > 일반 > 본문 형식'을 Common markdown 형식으로 지정

각주가 제대로 추가가 안 되는 경우 마크다운 형식이 제대로 기술되었는지 확인합니다.

레드마인 버전에 따라서 [1], fn1.와 같은 마크다운 형식을 사용하는 것으로 보이며, 제가 사용 중인 5.1.1 버전에서는 다음과 같은 형식의 마크다운 형식만 동작했습니다.

각주를 달 본문 영역:

Markdown

Here is some text with a footnote reference[^1].

이 외에 알려진 이슈로 Text colorizer와 같이 마크다운 또는 마크업(예: HTML, CSS) 언어를 사용하는 플러그인끼리 기능이 충돌하는 경우가 확인되었으니, 적용 후 문제가 있다면 사용 중인 플러그인을 점검하시기 바랍니다.