숏컷 코드

```js
console.log("hello");
```

```python
for value in numbers:
    print(value)
```

```bash
git status
```

문법

언어 지정은 문법 강조의 힌트이지 실행 환경을 의미하지 않는다

fenced code block 시작 줄에 언어 이름을 쓰면 렌더러가 해당 언어의 문법 강조 규칙을 적용한다. 단, 이것은 렌더러에 대한 힌트일 뿐이며 실제 코드를 실행하거나 검증하지는 않는다. 언어 이름을 생략하면 문법 강조 없이 plain text로 표시된다. 언어 이름의 표기는 렌더러마다 지원 목록이 다르므로 javascript 대신 js처럼 짧은 별칭이 더 널리 통용되는 경우도 있다.

```js
// 언어 지정: 문법 강조 적용
const x = 1;
```

```
// 언어 생략: plain text로 표시
const x = 1;
```

코드 블록 안에 backtick이 들어갈 때는 fence 길이를 늘려야 한다

삼중 backtick(```)이 기본이지만, 블록 안에 ```가 포함된 예시를 작성해야 한다면 fence를 4개 이상으로 늘리거나 물결표(~~~~)로 교체할 수 있다. 중요한 것은 시작 fence와 종료 fence의 길이와 문자가 동일해야 한다는 점이다. 이 규칙을 어기면 렌더러가 블록의 끝을 잘못 인식해 나머지 문서 전체가 코드로 처리되는 심각한 렌더링 오류가 발생한다.

````text
```nested fence example```
이렇게 하면 내부 backtick 3개가 그대로 보입니다.
````

들여쓰기 방식 코드 블록보다 fence 방식이 언어 지정과 이식성 모두에 유리하다

Markdown 초기 방식인 4칸 들여쓰기 코드 블록도 CommonMark가 지원하지만, 언어 지정이 불가능하고 목록 안에서 들여쓰기 수준과 충돌하기 쉽다. 모든 현대 기술 문서에서는 fenced code block을 기본으로 사용하는 것이 좋다. 특히 MDX처럼 Markdown과 JSX가 혼용되는 환경에서는 들여쓰기 블록이 파서 충돌을 일으킬 수 있어 반드시 fence 방식을 써야 한다.

<!-- 권장: fence 방식 -->
```bash
npm install
```

<!-- 비권장: 들여쓰기 방식 (언어 지정 불가) -->
    npm install

text 언어 지정은 렌더러가 강조를 시도하지 않도록 명시적으로 막는다

출력 예시, 오류 메시지, 파일 경로처럼 특정 언어 문법이 없는 내용은 text 또는 plain을 언어로 지정하면 된다. 언어를 생략해도 같은 결과가 나오지만, text를 명시하면 "의도적으로 강조를 끈 것"임을 다른 기여자에게 명확하게 전달할 수 있다. 일부 렌더러는 언어를 추측해 잘못된 강조를 적용하기도 하는데, text 지정이 이를 방지한다.

반대로 실행 가능한 코드인데 언어를 비워 두면 복사성은 유지돼도 가독성이 크게 떨어진다. 코드 예시가 학습용인지 단순 출력 예시인지 먼저 구분하면 js/bash/text 선택이 쉬워진다.

```text
Error: ENOENT: no such file or directory, open 'config.json'
```

선택 기준

주의할 점

```js
const query = `
  select * from users;
`;
```

이런 예시는 문자열 안 backtick과 fence가 섞여 보여 헷갈리기 쉽습니다. fence와 코드 내용을 분리해서 읽고, 필요하면 바깥 fence를 더 길게 잡는 편이 안전합니다.