diff --git a/docs/pages/release_notes.md b/docs/pages/release_notes.md
index 4e9f375bc3..e60e1a4bb0 100644
--- a/docs/pages/release_notes.md
+++ b/docs/pages/release_notes.md
@@ -22,16 +22,16 @@ This is a {{ site.pmd.release_type }} release.
 ### API Changes
 
 * Several classes and interfaces from the properties framework are now deprecated and will be removed with 7.0.0.
-  * MethodProperty, FloatProperty, FileProperty, TypeProperty and their multi-valued counterparts
+  * `MethodProperty`, `FloatProperty`, `FileProperty`, `TypeProperty` and their multi-valued counterparts
     are discontinued for lack of a use-case, and will probably not be replaced with 7.0.0.
-    Users of FloatProperty should consider using a DoubleProperty.
-  * EnumeratedPropertyDescriptor, NumericPropertyDescriptor, PackagedPropertyDescriptor, and the related builders
-    (in net.sourceforge.pmd.properties.builders) will be removed. In the future, these interfaces won't be around
+    Users of `FloatProperty` should consider using a `DoubleProperty`.
+  * `EnumeratedPropertyDescriptor`, `NumericPropertyDescriptor`, `PackagedPropertyDescriptor`, and the related builders
+    (in `net.sourceforge.pmd.properties.builders`) will be removed. In the future, these interfaces won't be around
     but their functionality will, under another form. The related methods `PropertyTypeId#isPropertyNumeric` and
     `PropertyTypeId#isPropertyPackaged` are also deprecated.
   * All classes of net.sourceforge.pmd.properties.modules are deprecated and will be removed. They were
     never intended as public api.
-  * The classes PropertyDescriptorField, PropertyDescriptorBuilderConversionWrapper, and the methods
+  * The classes `PropertyDescriptorField`, `PropertyDescriptorBuilderConversionWrapper`, and the methods
     `PropertyDescriptor#attributeValuesById`, `PropertyDescriptor#isDefinedExternally` and `PropertyTypeId#getFactory` are deprecated with no
     intended replacement. These were used to read and write properties to and from XML, and were never
     intended as public API.