qr shortcode

qr은 본문 안의 텍스트를 QR 코드 이미지로 바꿔 주는 shortcode입니다.
짧은 링크, 전화번호, 연락처, 등록 URL 같은 정보를 빠르게 전달하고 싶을 때 적합합니다.

공식 문서 기준으로 text, level, scale, targetDir, alt 등의 인자를 사용할 수 있습니다.
text는 self-closing 방식 또는 본문 내 텍스트 둘 다 지원하고, level은 오류 정정 수준을 정합니다. citeturn241043view0

렌더링 결과: self-closing

원형: self-closing

{{< qr text="https://gohugo.io" >}}

렌더링 결과: tag pair

원형: tag pair

{{< qr >}}
https://gohugo.io/shortcodes/
{{< /qr >}}

렌더링 결과: vCard 스타일

QR code of vCard for John Smith

원형: vCard 스타일

{{< qr
  level="low"
  scale=2
  alt="QR code of vCard for John Smith"
>}}
BEGIN:VCARD
VERSION:2.1
N;CHARSET=UTF-8:Smith;John;R.;Dr.;PhD
FN;CHARSET=UTF-8:Dr. John R. Smith, PhD.
ORG;CHARSET=UTF-8:ABC Widgets
TITLE;CHARSET=UTF-8:Vice President Engineering
TEL;TYPE=WORK:+12065550101
EMAIL;TYPE=WORK:jsmith@example.org
END:VCARD
{{< /qr >}}

해석 포인트

  • text는 가장 기본적인 입력입니다.
  • 본문 태그 사이에 넣는 방식은 긴 vCard 같은 구조화 텍스트에 편합니다.
  • level은 정보량이 많을수록 중요합니다.
  • scale은 결과 이미지의 픽셀 밀도를 결정하므로, 너무 작게 두면 스캔이 어려울 수 있습니다.

실무 팁

  • QR은 페이지 이동, 가입, 문의, 데모 신청 같은 행동 유도에 잘 맞습니다.
  • alt 텍스트를 적절히 주면 접근성에도 도움이 됩니다.
  • 생성된 이미지는 publishDir 아래에 저장되므로 정적 자산 관리 흐름을 함께 생각해야 합니다.