Index: head/www/firefox/pkg-message
===================================================================
--- head/www/firefox/pkg-message	(revision 510798)
+++ head/www/firefox/pkg-message	(revision 510799)
@@ -1,45 +1,48 @@
 [
 { type: install
   message: <<EOM
-Some features available on other platforms are not implemented:
+## Missing features
+
+Some features found on Windows, macOS and Linux are not implemented:
+
 - Native audio (requires OSS backend, feature parity with ALSA or PulseAudio)
 - Encrypted Media Extensions (requires Widevine CDM binary)
 - Process sandboxing (requires Capsicum backend)
 - Reduced memory usage (requires mozjemalloc)
 - Crash Reporter (requires Google Breakpad and reproducible builds)
 - Performance profiling (requires GeckoProfiler)
 - Gamepad API (requires libusbhid backend)
 - WebVR (requires open source runtime)
 - TCP fast open
-- about:networking (requires link state notification)
+- `about:networking` (requires link state notification)
 
+## Crashes on FreeBSD 11.2
 
+Web Content process may frequently crash due to a [kernel bug].
+Either upgrade to FreeBSD 11.3 or try the following workaround:
 
-On FreeBSD < 11.3 Web Content process may frequently crash due to bug 181741.
-If you cannot upgrade try applying the following workaround:
+    $ sysctl net.local.stream.recvspace=16384
 
-$ sysctl net.local.stream.recvspace=16384
+[kernel bug]: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=181741
 
+## Audio backend
 
+To select non-default audio backend open `about:config` page and
+create `media.cubeb.backend` preference. Supported values are: `alsa`,
+`jack`, `pulse`, `pulse-rust`, `sndio`. Currently used backend can be
+inspected on `about:support` page.
 
-To select non-default audio backend open about:config page and create
-media.cubeb.backend preference. Supported values are: alsa, jack,
-pulse, pulse-rust, sndio. Currently used backend can be inspected
-on about:support page.
-
-
-
-smb:// issues (Gvfs/GIO option):
+## smb:// issues
 Network group, machine, and share browsing does not work correctly.
 
-sftp:// (Gvfs/GIO option):
-Only sftp access using public key authentication works.  To easily
-setup public key authentication to "remote_host":
+## sftp://
+Only sftp access using public key authentication works. To easily
+setup public key authentication to `remote_host`:
 
-ssh-keygen
-cat ~/.ssh/id_rsa.pub | ssh remote_host "cat >> .ssh/authorized_keys"
+    $ ssh-keygen
+    $ cat ~/.ssh/id_rsa.pub | ssh remote_host "cat >> .ssh/authorized_keys"
 
-The SSH server on remote_host must allow pub key authentication.
+The SSH server on `remote_host` must allow pub key authentication.
 EOM
 }
 ]
Index: head/www/firefox-esr/pkg-message
===================================================================
--- head/www/firefox-esr/pkg-message	(revision 510798)
+++ head/www/firefox-esr/pkg-message	(revision 510799)
@@ -1,44 +1,48 @@
 [
 { type: install
   message: <<EOM
-Some features available on other platforms are not implemented:
+## Missing features
+
+Some features found on Windows, macOS and Linux are not implemented:
+
 - Native audio (requires OSS backend, feature parity with ALSA or PulseAudio)
 - Encrypted Media Extensions (requires Widevine CDM binary)
 - Process sandboxing (requires Capsicum backend)
 - Reduced memory usage (requires mozjemalloc)
 - Crash Reporter (requires Google Breakpad and reproducible builds)
 - Performance profiling (requires GeckoProfiler)
 - Gamepad API (requires libusbhid backend)
 - WebVR (requires open source runtime)
 - TCP fast open
+- `about:networking` (requires link state notification)
 
+## Crashes on FreeBSD 11.2
 
+Web Content process may frequently crash due to a [kernel bug].
+Either upgrade to FreeBSD 11.3 or try the following workaround:
 
-On FreeBSD < 11.3 Web Content process may frequently crash due to bug 181741.
-If you cannot upgrade try applying the following workaround:
+    $ sysctl net.local.stream.recvspace=16384
 
-$ sysctl net.local.stream.recvspace=16384
+[kernel bug]: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=181741
 
+## Audio backend
 
+To select non-default audio backend open `about:config` page and
+create `media.cubeb.backend` preference. Supported values are: `alsa`,
+`jack`, `pulse`, `pulse-rust`, `sndio`. Currently used backend can be
+inspected on `about:support` page.
 
-To select non-default audio backend open about:config page and create
-media.cubeb.backend preference. Supported values are: alsa, jack,
-pulse, pulse-rust, sndio. Currently used backend can be inspected
-on about:support page.
-
-
-
-smb:// issues (Gvfs/GIO option):
+## smb:// issues
 Network group, machine, and share browsing does not work correctly.
 
-sftp:// (Gvfs/GIO option):
-Only sftp access using public key authentication works.  To easily
-setup public key authentication to "remote_host":
+## sftp://
+Only sftp access using public key authentication works. To easily
+setup public key authentication to `remote_host`:
 
-ssh-keygen
-cat ~/.ssh/id_rsa.pub | ssh remote_host "cat >> .ssh/authorized_keys"
+    $ ssh-keygen
+    $ cat ~/.ssh/id_rsa.pub | ssh remote_host "cat >> .ssh/authorized_keys"
 
-The SSH server on remote_host must allow pub key authentication.
+The SSH server on `remote_host` must allow pub key authentication.
 EOM
 }
 ]