diff --git a/README.md b/README.md
index ea3aebb..e2c02c4 100644
--- a/README.md
+++ b/README.md
@@ -19,13 +19,20 @@ See `example/pingpong.js` for a simple example of receiving and sending data.
 
 # API
 
-The modules exports a single class `RFM9x`. The constructor requires no arguments. 
+The modules exports a single class `RFM9x`. The constructor requires no arguments.
+
+```js
+const rfm9x = require('rfm9x');
+const module = new rfm9x();
+
+await module.init({ ... });
+```
 
 ## Properties
 
-* `debug` - Output SPI debug information
+* [`debug`](#debug) - Output SPI debug information
 
-### `debug`
+#### `debug`
 
 Set this property to `true` to get all SPI communication printed out to the console.
 
@@ -35,15 +42,15 @@ responses from other nodes.
 
 ## Methods
 
-* `init(options)` - Initialize module and LoRa settings
-* `startReceive()` - Puts the LoRa module in receive mode and enables the `receive` event
-* `stopReceived()` - Puts the LoRa module in standby mode and stops receiving packets
-* `send(payload)` - Sends a packet via LoRa
-* `getVersion()` - Gets the chip version number from the module
+* [`init(options)`](#initoptions) - Initialize module and LoRa settings
+* [`startReceive()`](#startreceive) - Puts the LoRa module in receive mode and enables the `receive` event
+* [`stopReceive()`](#stopreceive) - Puts the LoRa module in standby mode and stops receiving packets
+* [`send(payload)`](#sendpayload) - Sends a packet via LoRa
+* [`getVersion()`](#getversion) - Gets the chip version number from the module
 
-### `init(options)`
+#### `init(options)`
 
-- `options`: Options object (see below). All properties are optional, default values will be
+- `options` - Options object (see below). All properties are optional, default values will be
 used when omitted.
 
 Initialize module and LoRa settings. Needs to be called before using any of the radio functions.
@@ -52,39 +59,39 @@ Returns a Promise that resolves with no value.
 
 The following options are supported:
 
-- `frequencyMhz`: Base frequency in MHz, default: `915`
-- `preambleLength`: LoRa preamble length in bytes, default: `8`
-- `bandwidthHz`: LoRa bandwidth in Hz, default: `500000`
-- `codingRate`: LoRa coding rate, valid values are `5` (4/5) to `8` (4/8), default: `5`
-- `spreadingFactor`: LoRa spreading factor, valid values are `6` to `12`, default: `7`
-- `enableCrcChecking`: Whether to enable CRC checking on incoming packets, default: `false`
-- `txPowerDb`: Transmitter power in dB, valid values are `5` to `23` (currently only high power mode is
+- `frequencyMhz` - Base frequency in MHz, default: `915`
+- `preambleLength` - LoRa preamble length in bytes, default: `8`
+- `bandwidthHz` - LoRa bandwidth in Hz, default: `500000`
+- `codingRate` - LoRa coding rate, valid values are `5` (4/5) to `8` (4/8), default: `5`
+- `spreadingFactor` - LoRa spreading factor, valid values are `6` to `12`, default: `7`
+- `enableCrcChecking` - Whether to enable CRC checking on incoming packets, default: `false`
+- `txPowerDb` - Transmitter power in dB, valid values are `5` to `23` (currently only high power mode is
 supported), default: `23`
-- `enableAgc`: Whether to enable Automatic Gain Control, default: `false`
-- `resetPin`: Number of the GPIO pin that the RFM9x RESET line is connected to, default: `25`
-- `dio0Pin`: Number of the GPIO pin that the RFM9x DIO0 line is connected to, default: `22`
-- `dio1Pin`: Number of the GPIO pin that the RFM9x DIO1 line is connected to (currently not used),
+- `enableAgc` - Whether to enable Automatic Gain Control, default: `false`
+- `resetPin` - Number of the GPIO pin that the RFM9x RESET line is connected to, default: `25`
+- `dio0Pin` - Number of the GPIO pin that the RFM9x DIO0 line is connected to, default: `22`
+- `dio1Pin` - *Not currently used.* Number of the GPIO pin that the RFM9x DIO1 line is connected to,
 default: `22`
-- `dio2Pin`: Number of the GPIO pin that the RFM9x DIO2 line is connected to (currently not used),
+- `dio2Pin` - *Not currently used.* Number of the GPIO pin that the RFM9x DIO2 line is connected to,
 default: `22`
-- `spiSpeedHz`: Speed of the SPI communication in Hz, default: `100000`
-- `txTimeoutMs`: Maximum time in milliseconds to wait for a packet transmission to finish, default: `2000`
+- `spiSpeedHz` - Speed of the SPI communication in Hz, default: `100000`
+- `txTimeoutMs` - Maximum time in milliseconds to wait for a packet transmission to finish, default: `2000`
 
-### `startReceive()`
+#### `startReceive()`
 
 Puts the LoRa module in receive mode and enables the `receive` event.
 
 Returns a Promise that resolves with no value.
 
-### `stopReceive()`
+#### `stopReceive()`
 
 Puts the LoRa module in standby mode and stops receiving packets.
 
 Returns a Promise that resolves with no value.
 
-### `send(payload)`
+#### `send(payload)`
 
-- `payload`: A `Buffer` of up to 255 bytes
+- `payload` - A `Buffer` of up to 255 bytes
 
 Sends a packet via LoRa.
 
@@ -94,27 +101,27 @@ Returns a Promise that resolves with no value after the transmission is finished
 continue receiving packets after a transmission, you will need to call `startReceive()` after the transmission
 completed.
 
-### `getVersion()`
+#### `getVersion()`
 
 Gets the chip version number from the module.
 
-Returns a Promise that resolves with the version number (`int`).
+Returns a Promise that resolves with the version number (one-byte integer).
 
 ## Events
 
-* `receive(packet)` - Emitted when a LoRa packet has been received
-* `receiveError()` - Emitted when an invalid LoRa packet has been received
+* [`receive(packet)`](#receivepacket) - Emitted when a LoRa packet has been received
+* [`receiveError()`](#receiveerror) - Emitted when an invalid LoRa packet has been received
 
-### `receive(packet)`
+#### `receive(packet)`
 
 Event that is emitted when a LoRa packet is received.
 
-Listeners are passed a packet object as an argument that contains the following properties:
-- `payload`: A `Buffer` containing the packet contents
-- `rssiDb`: RSSI of the packet in dB
-- `snrDb`: SNR of the packet in dB
+`packet` is an object containing the following properties:
+- `payload` - A `Buffer` containing the packet contents
+- `rssiDb` - RSSI of the packet in dB
+- `snrDb` - SNR of the packet in dB
 
-### `receiveError()`
+#### `receiveError()`
 
 Event that is emitted when a LoRa packet is received but was discarded due to receive errors (e.g. CRC check
 failed).