diff --git a/doc/api/url.markdown b/doc/api/url.markdown
index 3ace6995794..ef24a2a3bc9 100644
--- a/doc/api/url.markdown
+++ b/doc/api/url.markdown
@@ -82,6 +82,8 @@ Pass `true` as the third argument to treat `//foo/bar` as
 
 Take a parsed URL object, and return a formatted URL string.
 
+Here's how the formatting process works:
+
 * `href` will be ignored.
 * `protocol` is treated the same with or without the trailing `:` (colon).
   * The protocols `http`, `https`, `ftp`, `gopher`, `file` will be
@@ -97,9 +99,9 @@ Take a parsed URL object, and return a formatted URL string.
 * `host` will be used in place of `hostname` and `port`
 * `pathname` is treated the same with or without the leading `/` (slash).
 * `path` is treated the same with `pathname` but able to contain `query` as well.
-* `search` will be used in place of `query`.
 * `query` (object; see `querystring`) will only be used if `search` is absent.
-* `search` is treated the same with or without the leading `?` (question mark).
+* `search` will be used in place of `query`.
+  * It is treated the same with or without the leading `?` (question mark).
 * `hash` is treated the same with or without the leading `#` (pound sign, anchor).
 
 ## url.resolve(from, to)