fonts.md

 1# Fonts
 2
 3<!--
 4TBD: WIP. Zed Fonts documentation. This is currently not linked from SUMMARY.md are so unpublished.
 5-->
 6
 7Zed ships two fonts: Zed Plex Mono and Zed Plex Sans. These are based on IBM Plex Mono and IBM Plex Sans, respectively.
 8
 9<!--
10TBD: Document how Zed Plex font files were created. Repo links, etc.
11-->
12
13## Settings
14
15<!--
16TBD: Explain various font settings in Zed.
17-->
18
19- Buffer fonts
20  - `buffer-font-family`
21  - `buffer-font-features`
22  - `buffer-font-size`
23  - `buffer-line-height`
24- UI fonts
25  - `ui_font_family`
26  - `ui_font_fallbacks`
27  - `ui_font_features`
28  - `ui_font_weight`
29  - `ui_font_size`
30- Terminal fonts
31  - `terminal.font-size`
32  - `terminal.font-family`
33  - `terminal.font-features`
34- Other settings:
35  - `active-pane-magnification`
36
37## Old Zed Fonts
38
39Previously, Zed shipped with `Zed Mono` and `Zed Sans`, customized versions of the [Iosevka](https://typeof.net/Iosevka/) typeface. You can find more about them in the [zed-fonts](https://github.com/zed-industries/zed-fonts/) repository.
40
41Here's how you can use the old Zed fonts instead of `Zed Plex Mono` and `Zed Plex Sans`:
42
431. Download [zed-app-fonts-1.2.0.zip](https://github.com/zed-industries/zed-fonts/releases/download/1.2.0/zed-app-fonts-1.2.0.zip) from the [zed-fonts releases](https://github.com/zed-industries/zed-fonts/releases) page.
442. Open macOS `Font Book.app`
453. Unzip the file and drag the `ttf` files into the Font Book app.
464. Update your settings `ui_font_family` and `buffer_font_family` to use `Zed Mono` or `Zed Sans` in your `settings.json` file.
47
48```json
49{
50  "ui_font_family": "Zed Sans Extended",
51  "buffer_font_family": "Zed Mono Extend",
52  "terminal": {
53    "font-family": "Zed Mono Extended"
54  }
55}
56```
57
585. Note there will be red squiggles under the font name. (this is a bug, but harmless.)