Merge branch 'master' into ad/readme
diff --git a/README.md b/README.md
index 4e22b25..63779f5 100644
--- a/README.md
+++ b/README.md
@@ -13,10 +13,11 @@
 # Getting Started
 
 There is no need to use rules from this repository just yet. If you want to use
-rules\_cc anyway, add the following to your WORKSPACE file:
+`rules_cc` anyway, add the following to your `WORKSPACE` file:
 
-```
+```python
 load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
+
 http_archive(
     name = "rules_cc",
     urls = ["https://github.com/bazelbuild/rules_cc/archive/TODO"],
@@ -24,10 +25,11 @@
 )
 ```
 
-Then, in your BUILD files, import and use the rules:
+Then, in your `BUILD` files, import and use the rules:
 
-```
+```python
 load("@rules_cc//cc:defs.bzl", "cc_library")
+
 cc_library(
     ...
 )
@@ -46,19 +48,21 @@
 
 TLDR:
 
-    bazel run @rules_cc//tools/migration:legacy_fields_migrator -- \
-      --input=my_toolchain/CROSSTOOL \
-      --inline
+```
+bazel run @rules_cc//tools/migration:legacy_fields_migrator -- \
+  --input=my_toolchain/CROSSTOOL \
+  --inline
+```
 
 # Contributing
 
-Bazel and rules_cc are the work of many contributors. We appreciate your help!
+Bazel and `rules_cc` are the work of many contributors. We appreciate your help!
 
 To contribute, please read the contribution guidelines: [CONTRIBUTING.md](https://github.com/bazelbuild/rules_cc/blob/master/CONTRIBUTING.md).
 
-Note that the rules_cc use the GitHub issue tracker for bug reports and feature requests only.
+Note that the `rules_cc` use the GitHub issue tracker for bug reports and feature requests only.
 For asking questions see:
 
 * [Stack Overflow](https://stackoverflow.com/questions/tagged/bazel)
-* [rules_cc mailing list](https://groups.google.com/forum/#!forum/cc-bazel-discuss)
+* [`rules_cc` mailing list](https://groups.google.com/forum/#!forum/cc-bazel-discuss)
 * Slack channel `#cc` on [slack.bazel.build](https://slack.bazel.build)