フォントしたい（#text）

1#set text(
2  lang: "ja",
3  font: "Harano Aji Gothic",
4  size: 12pt,
5  weight: "regular",
6)

text要素で、本文のフォント設定などを変更できます。 ドキュメント全体の設定はsetルールで一括設定します。

上記のサンプルは日本語のドキュメント作成のときにコピペで使い回している設定です。 LaTeXと比べると和文フォントがとても簡単に設定できます。

注釈

TypstAppの場合、 デフォルトが、よく分からない明朝フォントになっているため、日本語フォントへの変更は必須です。

参考

フォントサイズしたい（size）

1#set text(
2  size: 11pt
3)

sizeオプションで、フォントサイズを変更できます。 デフォルトは11ptです。

1#show heading.where(level: 1): set text(size: 18pt, weight: "bold")
2#show heading.where(level: 2): set text(size: 16pt, weight: "semibold")
3#show heading.where(level: 3): set text(size: 14pt, weight: "medium")
4#show heading.where(level: 4): set text(size: 12pt, weight: "medium", style: "italic")

上記のサンプルのように、見出しレベルごとにフォントサイズを変更できます。

文字色したい（fill）

1#set text(
2  fill: luma(80%)
3)

fillオプションで、フォントの色を変更できます。 デフォルトはluma(0%)です。

Typstにはさまざまな 色の設定方法 があります。

基本的には RGB関数 でRGB値とA値を設定すればよいです。 グレイスケールを使う場合は luma関数 があります。 印刷物を作成する場合は cymk関数 を使うのがよいかもしれません。

言語設定したい（lang）

1#set text(
2  lang: "ja"
3)

langオプションで、ドキュメントの言語を変更できます。 言語コードはISO639-1/2/3から選択します。 デフォルトは"en"です。 日本語の場合は"ja"にします。

注釈

ウェブアプリ限定かもしれませんが、 lang: "ja"に設定することで、 スペルチェックによるエラーを抑制できました。

フォントしたい（font）

1#text(font: "HackGen")[HackGen; 白源]
2#text(font: "HackGen Console")[HackGen Console; 白源コンソール]
3#text(font: "HackGen35")[HackGen35; 白源35]
4
5#text(font: "Noto Serif CJK JP")[Noto Serif CJK JP]
6#text(font: "Noto Sans CJK JP")[Noto Sans CJK JP]
7
8#text(font: "Futura")[Futura; フツラ]
9#text(font: "Yusei Magic")[Yusei Magic; たぬき油性マジック]

text要素のfontオプションでフォントを変更できます。 #text(font: フォント名)[本文]で、部分的にフォントを変更できます。

ウェイトしたい（weight）

1#set text(weight: "thin")       // 100
2#set text(weight: "extralight") // 200
3#set text(weight: "light")      // 300
4#set text(weight: "regular")    // 400
5#set text(weight: "medium")     // 500
6#set text(weight: "semibold")   // 600
7#set text(weight: "bold")       // 700
8#set text(weight: "extrabold")  // 800
9#set text(weight: "black")      // 900

weightオプションで、フォントのウェイト（＝太さ）を変更できます。 デフォルトは"regular"です。

フォントの書体を選ぶときは、ウェイトがたくさんある書体がオススメです。 見出しと本文でウェイトを変えるだけで、よみやすいドキュメントが作成できます。

利用できるフォントを確認したい（typst fonts）

$ typst fonts
$ typst fonts --variants

typst fontsコマンドで、利用可能なフォントの一覧を確認できます。 --variantsオプションでより詳細な情報を確認できます。

フォント名を指定して表示する機能はないようなので、ripgrepなど検索コマンドと組み合わせて探します。

ヒント

僕はフォントをHomebrew経由でインストールしています。 Typstでは、フォントパスを追加設定することなく、使うことができています。

以下に、困ったときにオススメの日本語フォントを紹介します。

ヒラギノフォント

$ typst fonts | rg Hiragino
Hiragino Kaku Gothic Interface
Hiragino Kaku Gothic Pro
Hiragino Kaku Gothic ProN
Hiragino Kaku Gothic Std
Hiragino Kaku Gothic StdN
Hiragino Maru Gothic Pro
Hiragino Maru Gothic ProN
Hiragino Mincho Pro
Hiragino Mincho ProN
Hiragino Sans
Hiragino Sans CNS
Hiragino Sans GB
Hiragino Sans GB Interface

ヒラギノフォントは、macOSに標準搭載されている日本語フォントファミリーです。 角ゴシック体、丸ゴシック体、明朝体には、 利用できる文字種によりStd、StdN、Pro、ProNの区分があります。 とりあえずProNを使えばよいと思います。

また、2015年ころに、多言語対応のサンセリフ体が追加されました。 ウェイトも豊富なので、簡単に統一感のあるドキュメントを作りたいときに便利です。

Notoフォント

$ typst fonts | rg "Noto" |
 rg "CJK"
Noto Sans CJK JP
Noto Serif CJK JP

NotoフォントはGoogleとAdobeが共同開発したフォントです。 Noto Sans CJK JPはサンセリフ体（＝ゴシック体）、 Noto Serif CJK JPはセリフ体（＝明朝体）です。 日英混植のドキュメントで活躍します。

注釈

Google側のフォント名がNotoで、 Adobe側のフォント名がSource Han（源ノ角）です。 基本的に同じフォントです。

游ゴシック／游明朝フォント

$ typst fonts |
 rg "Yu[Gothic,Mincho]"
YuGothic
YuMincho
YuMincho +36p Kana

游ゴシック／游明朝フォントは、字游工房が開発した日本語フォントです。 WindowsやmacOSに標準搭載されています。

HackGenフォント

$ typst fonts | rg HackGen
HackGen
HackGen Console
HackGen Console NF
HackGen35
HackGen35 Console
HackGen35 Console NF

HackGen（白源）は、プログラミン向けに設計された日本語対応の等幅フォントです。 日本語のコメントが入ったコードブロックのフォント設定に向いています。

HackGenは半角1:全角2の純粋な等幅フォント、 HackGen35は可読性を優先させるために半角3:全角5としたフォントです。 NFはNerd Fontのことで、絵文字やFontAwesomeなどに対応しています。 日常のターミナル操作などにも向いています。

注釈

tawara (yuru7)さん が個人開発しているフォントです。 他にもPlemolJP、moralerspaceなどのさまざまなフォントを開発している方です。 すべて日本語に対応しているのでありがたく使わせていただいております。

ポップなフォント

$ typst fonts | rg One
Cherry Bomb One
Darumadrop One
Klee One
Merienda One
Monomaniac One
Rampart One
Reggae One
RocknRoll One
Train One

* OneフォントはFontWorksが開発したフォントです。 Google Fontsとして提供されているので無料で利用できます。 ポップなフォントなので、カジュアルさを出したいときに利用できます。

リファレンス