diff --git a/README.md b/README.md
index 51ec17e523..e1242927e3 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,15 @@
-# openHAB 2 Core
+# openHAB Core
 
 [![Build Status](https://travis-ci.org/openhab/openhab-core.svg)](https://travis-ci.org/openhab/openhab-core)
 [![EPL-2.0](https://img.shields.io/badge/license-EPL%202-green.svg)](https://opensource.org/licenses/EPL-2.0)
 [![Bountysource](https://www.bountysource.com/badge/tracker?tracker_id=28054058)](https://www.bountysource.com/teams/openhab/issues?tracker_ids=28054058)
 
-This project contains core bundles of the openHAB 2 runtime.
+This project contains core bundles of the openHAB runtime.
 
 Building and running the project is fairly easy if you follow the steps detailed below.
 
-Please note that openHAB 2 Core is not a product itself, but a framework to build solutions on top.
-It is picked up by the main [openHAB distribution build](https://github.com/openhab/openhab-distro).
+Please note that openHAB Core is not a product itself, but a framework to build solutions on top.
+It is picked up by the main [openHAB distribution](https://github.com/openhab/openhab-distro).
 
 This means that what you build is primarily an artifact repository of OSGi bundles that can be used within smart home products.
 
@@ -23,21 +23,23 @@ What you need before you start:
 
 - Maven 3 from https://maven.apache.org/download.html
 
-Make sure that the "mvn" command is available on your path
+Make sure that the `mvn` command is available on your path
 
 ## 2. Checkout
 
 Checkout the source code from GitHub, e.g. by running:
 
+```
 git clone https://github.com/openhab/openhab-core.git
+```
 
 ## 3. Building with Maven
 
 To build this project from the sources, Maven takes care of everything:
 
-- set MAVEN_OPTS to "-Xms512m -Xmx1024m"
-- change into the openhab-core directory ("cd openhab-core“)
-- run "mvn clean install" to compile and package all sources
+- set `MAVEN_OPTS` to `-Xms512m -Xmx1024m`
+- change into the openhab-core directory (`cd openhab-core`)
+- run `mvn clean install` to compile and package all sources
 
 If there are tests that are failing occasionally on your local build, run `mvn -DskipTests=true clean install` instead to skip them.