diff --git a/README.md b/README.md
index 6a8076c97a..f7db9aceae 100644
--- a/README.md
+++ b/README.md
@@ -124,13 +124,13 @@ docker-compose down
 
 The default configuration for local builds of the documentation disables some
 features to allow for a shorter build-time. The following options differ between
-local builds, and builds that are deployed to docs.docker.com:
+local builds, and builds that are deployed to [docs.docker.com](https://docs.docker.com/):
 
 - search auto-completion, and generation of `js/metadata.json`
 - google analytics
 - page ratings
 - `sitemap.xml` generation
-- minification of stylesheets (css/style.css)
+- minification of stylesheets (`css/style.css`)
 - adjusting "edit this page" links for content in other repositories
 
 If you want to contribute in these areas, you can perform a "production" build
@@ -275,7 +275,7 @@ When applicable, capture windows rather than rectangular regions. This
 eliminates unpleasant background and saves the editors the need to crop.
 
 On Mac, capture windows without shadows. To this end, once you pressed
-`Command-Shift-4`, press Option while clicking on the window. To disable
+<kbd>Command-Shift-4</kbd>, press <kbd>Option</kbd> while clicking on the window. To disable
 shadows once for all, run:
 
 ```bash