@@ -134,6 +134,8 @@ or install it with [scoop](https://scoop.sh/):
134134scoop install bat
135135```
136136
137+[See below](#using-bat-on-windows) for notes.
138+
137139### From binaries
138140
139141Check out the [Release page](https://github.com/sharkdp/bat/releases) for
@@ -235,6 +237,28 @@ script as a wrapper, for example:
235237less --tabs 4 -RF "$@"
236238```
237239
240+## Using `bat` on Windows
241+
242+`bat` mostly works out-of-the-box on Windows, but a few features may need extra configuration.
243+
244+### Paging
245+
246+Windows only includes a very limited pager in the form of `more`. You can download a Windows binary
247+for `less` [from its homepage](http://www.greenwoodsoftware.com/less/download.html) or [through
248+Chocolatey](https://chocolatey.org/packages/Less). To use it, place the binary in a directory in
249+your `PATH` or [define an environment variable](#using-a-different-pager).
250+
251+### Colours
252+
253+Windows 10 natively supports colours in both `conhost.exe` (Command Prompt) and PowerShell since
254+[v1511](https://en.wikipedia.org/wiki/Windows_10_version_history#Version_1511_(November_Update)), as
255+well as in newer versions of bash. On earlier versions of Windows, you can use
256+[Cmder](http://cmder.net/), which includes [ConEmu](https://conemu.github.io/).
257+
258+**Note:** The Git and MSYS versions of `less` do not correctly interpret colours on Windows. If you
259+don’t have any other pagers installed, you can disable paging entirely by passing `--paging=never`
260+or by setting `BAT_PAGER` to an empty string.
261+
238262## Troubleshooting
239263
240264### Terminals & colors