diff --git a/stlinkv1_macosx_driver/README b/stlinkv1_macosx_driver/README.md
similarity index 78%
rename from stlinkv1_macosx_driver/README
rename to stlinkv1_macosx_driver/README.md
index 0c789489c..4e6b8c6a0 100644
--- a/stlinkv1_macosx_driver/README
+++ b/stlinkv1_macosx_driver/README.md
@@ -1,4 +1,5 @@
 from: marco.cassinerio@gmail.com
+
 to: texane@gmail.com
 
 Hi,
@@ -14,24 +15,39 @@ version as well.
 
 Attached to this mail you'll find the osx folder with the source code of the driver, both drivers (for
 10.6.x and 10.7.x), an install.sh script and the modified Makefile, i only added a line at the end which
-invoke the install.sh.
+invoke the `install.sh`.
 
-First, unpack the osx.tar.gz contents:
+First, unpack the `osx.tar.gz` contents:
+```bash
 tar xzvf osx.tar.gz
+```
 
 Then, install the driver using:
+```bash
 sudo make osx_stlink_shield
+```
 
 no reboot required.
 
 P.S. If error `OS X version not supported` occurs. For the latest versions of Mac OS X you may need to change the `osx/install.sh` as follows:
-```
+```bash
 < ISOSXLION=$(sw_vers -productVersion)
 ---
 > ISOSXLION=$(sw_vers -productVersion | sed -e 's:.[[:digit:]]*$::')
 ```
-FOR OS X 10.10 Yosemite you must force the system to load unsigned kernelextensions
 
+### OS X 10.10 Yosemite
+
+For OS X 10.10 Yosemite you must force the system to load unsigned kernelextensions
+
+```bash
 sudo nvram boot-args="kext-dev-mode=1“
+```
 
 reboot the system!
+
+### OS X 10.11 El Capitan
+
+(Update from another user)
+
+For OS X 10.11 El Capitan: the Yosemite kext seems to work (tested on 10.11.04).