앵커 사용

Hugo에서는 Markdown 파일 내에서 앵커 링크를 사용하는 것이 가능합니다. 일반적으로 헤딩에 자동으로 ID가 생성되기 때문에 링크의 끝에 #헤딩ID 형식으로 추가하여 해당 위치로 연결할 수 있습니다. 예를 들어, #heading 형식으로 링크를 만들면 해당 페이지에서 그 헤딩 위치로 이동합니다.

헤딩 ID 자동 생성 규칙

  • Hugo는 헤딩 텍스트를 기반으로 ID를 자동으로 생성합니다. 이때 공백은 -로 대체되고 소문자로 변환됩니다.
  • 예를 들어, ## Sample Heading#sample-heading ID를 가집니다.

링크 예시

  • 페이지 내 특정 헤딩에 링크하려면, 해당 페이지 경로 뒤에 #헤딩ID를 추가하여 링크할 수 있습니다.
    [이동할 헤딩](페이지경로#헤딩ID)

브라우저 캐시 및 페이지 로딩

일부 경우 앵커 링크가 제대로 동작하지 않을 때가 있는데, 이는 캐시 문제이거나 페이지가 로드되기 전에 앵커로 이동을 시도할 때 발생할 수 있습니다. 이 경우 브라우저 캐시를 지우거나 페이지 로딩 후 링크를 클릭하는 방식으로 테스트해 볼 수 있습니다. 여전히 문제가 발생한다면 앵커 ID가 제대로 생성되었는지 확인하거나, 커스텀 ID를 직접 설정해보는 방법도 고려해볼 수 있습니다.