마크다운 문서 내의 목차 적용기(ing)

• 마크다운 문서 내의 목차가 필요하다
  • 적용 방법
  • 겪은 이슈와 시도한 방법
  • 왜 적용이 안될까?

---

마크다운 문서 내의 목차가 필요하다

블로그에 공부한 내용을 정리하면서 내용이 길 경우에는 어떤 내용이 있는지
그 구조가 한 눈에 들어오지 않는 불편함이 있었다.
목차의 제목을 클릭했을 때, 원하는 제목으로 바로 이동할 수 있도록 만들고 싶었다.
검색 결과 그대로 적용하다가 문제가 발생해서 해당 이슈에 대해서도 정리해보고자 한다.

적용 방법

마크다운 문법으로 원하는 목차의 제목에 링크를 거는 방법을 알아보자.
1. 띄어쓰기가 있는 부분은 -로 연결해주고,
2. 영어는 모두 소문자로 만들어줘야 한다.

[보여지는 내용](#이동하고자 하는 내용)

겪은 이슈와 시도한 방법

이렇게 보면 적용 방법은 간단한데, 한 가지 문제가 발생했다.
저장하기 전 상태에서는 문제가 없어 보였다.

저장 후의 모습이 아래와 같이 바뀌었다.
링크를 감싸고 있는 소괄호() 안에 소괄호()가 중첩된 경우에 이슈가 발생했다.

목차명에 괄호나 점, 쉼표 등의 특수문자가 들어갔을 경우에는 무시하면 된다.
특수문자를 제외하고 이동하고자 하는 링크의 내용만 적으면 된다는 점을 알게 되었다.

ex) 이동하고자 하는 링크가 2xx 성공(Success)라면, 특수문자인 ()는 제외하고 이어서 써주면 된다.
소괄호()안의 내용에는 2xx-성공success라고 적어주면 된다.

왜 적용이 안될까?

아래와 같이 특수문자를 제외하고 작성했고, vsCode에서는 링크를 잘 찾아가는 걸 확인했다.

그런데 hexo server를 띄워서 확인하면 링크로 이동하지 않는다.
문제가 뭘까? 어느 부분이 잘못 되었는지, 해결 방법을 더 찾아보고 해결한 방법을 추가로 남겨야 겠다.