렌더링에 따른 코드블록 출력 오류 해결하기

렌더링에 따른 코드블록 출력 오류 해결하기

블로그 작성시 렌더링 플랫폼에 따라 코드블록이 정상적으로 출력되지 않는 경우가 있다. 예를 들면 Quarto에서 변수로 사용하는 {{< meta 변수 >}} 구문이나 Hugo 스타일에서 사용하는 shortcodes {{< >}} 등을 사용할 경 jekyll에서 렌더링시 코드블록이 정상적으로 출력되지 않는다. 즉, 해당 코드가 사라지는 문제가 발생한다.

이런 문제를 해결할 수 있는 몇가지 방법을 알아 본다.

{% raw %} 블록 사용

Version: {{< meta version >}}

중괄호를 코드로 표기

또는 아래와 같이 HTML entity를 이용한 표현도 가능하다({ → {, } → }).

Version: {{< meta version >}}

<pre><code> 태그 사용

<pre><code>
  Version: 
</code></pre>

이건 렌더링에 따라 될, 또는 안될 수도 있다.

상황에 맞춰 선호하는 방법을 적용한다.

참고자료