シンタックスハイライト

Hugo は構文強調表示に、純粋な Go で書かれた汎用シンタックスハイライタ Chroma を使用しています。 Markdown コンテンツ内のコードブロックにはバッククォートを使用することを推奨します。例えば:

Markdown

```python
def say_hello():
    print("Hello!")
```

は次のようにレンダリングされます:

def say_hello():
    print("Hello!")

機能

コードブロックにファイル名やタイトルを追加するには、filename 属性を設定します:

Markdown

```python {filename="hello.py"}
def say_hello():
    print("Hello!")
```

hello.py

def say_hello():
    print("Hello!")

base_url 属性を使用してベース URL を指定し、ファイル名と組み合わせてリンクを生成できます。

ファイル名には、ベースパス内のファイルの場所を指定する相対パスを含めることができます。

Markdown

```go {base_url="https://github.com/imfing/hextra/blob/main/",filename="exampleSite/hugo.work"}
go 1.20
```

go 1.20

行番号を表示するには、linenos 属性を table に設定し、必要に応じて linenostart で開始行番号を指定します:

Markdown

```python {linenos=table,linenostart=42}
def say_hello():
    print("Hello!")
```

42
43
def say_hello():
    print("Hello!")

特定の行をハイライト表示するには、hl_lines 属性に行番号のリストを設定します:

Markdown

```python {linenos=table,hl_lines=[2,4],linenostart=1,filename="hello.py"}
def say_hello():
    print("Hello!")

def main():
    say_hello()
```

hello.py

1
2
3
4
5
def say_hello():
    print("Hello!")

def main():
    say_hello()

デフォルトでコードブロックにはコピーボタンが有効になっています。この動作はサイト設定ファイルで変更できます:

hugo.yaml

42
43
44
45
46
47
params:
  highlight:
    copy:
      enable: true
      # hover | always
      display: hover

対応言語の一覧については、Chroma のドキュメントを参照してください。

最終更新日 8月 14, 2025