1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
# termmd configuration.
#
# Copy to ~/.config/termmd/config.toml, or point $TERMMD_CONFIG at it.
# Every setting here is optional and mirrors a command-line flag; flags win.
# Unknown keys are an error, so a typo is reported rather than ignored.
# --- appearance -------------------------------------------------------------
# A built-in theme (dark, light, mono) or the name of a file in
# ~/.config/termmd/themes/, or a path to one.
= "dark"
# Pick a theme by terminal background instead. Only used when the terminal
# answers the background-colour query; otherwise `theme` applies.
# light-theme = "light"
# dark-theme = "midnight"
# Code highlighting theme. `termmd --list-themes` shows what is available.
# On a 16-colour terminal termmd uses "ansi" by default, which follows your own
# palette rather than fixing RGB values.
# syntax-theme = "base16-ocean.dark"
# Text width, and the blank columns kept at each side. Without `width`, termmd
# uses the terminal width capped at 100 columns.
# width = 100
= 1
# Rules under level 1 and 2 headings.
= true
# Line numbers beside code blocks.
= false
# Curly quotes, en and em dashes, ellipses.
= true
# --- pager ------------------------------------------------------------------
# Use the interactive pager when stdout is a terminal. A document that already
# fits on one screen is printed rather than paged either way.
= true
# Whether termmd asks the terminal to report the mouse to it.
#
# Off by default, and worth understanding before turning on. With it off, your
# terminal keeps the mouse: drag selects text, and the wheel still scrolls
# because termmd enables alternate scroll (the terminal sends arrow keys).
#
# With it on, termmd sees clicks and can follow links itself -- including
# in-document anchors and links to other local Markdown files, which a terminal
# cannot do -- but click-drag selection needs `shift`. Press `m` to switch at any
# time.
= false
# --- images -----------------------------------------------------------------
= true
# Force a protocol instead of detecting one:
# kitty | iterm2 | sixel | blocks | none
# image-protocol = "kitty"
# Fetch images over http(s). Off by default: viewing a document should not make
# network requests unless you ask for it.
= false
# The tallest an image may be, in terminal rows.
= 24
# Centre block images and their captions.
= true
# --- links and terminal -----------------------------------------------------
# auto OSC 8 hyperlinks when supported, otherwise inline URLs
# hyperlink always OSC 8
# inline always print the URL next to the text
# reference number the links and list them at the end
# hide link text only
= "auto"
# auto | always | never | 16 | 256 | truecolor
= "auto"
# auto | ascii | extended | full
= "auto"
# Ask the terminal what it supports at startup. Turning this off skips a query
# that costs up to 300ms on a terminal that never answers.
= true
# Columns a tab expands to inside code blocks.
= 4