diff --git a/connectors/connid/1.x/connector-development-guide/index.adoc b/connectors/connid/1.x/connector-development-guide/index.adoc
index e7d1d31e..97e3bee5 100644
--- a/connectors/connid/1.x/connector-development-guide/index.adoc
+++ b/connectors/connid/1.x/connector-development-guide/index.adoc
@@ -93,7 +93,7 @@ The connector just translates protocols and data formats.
 
 The connector works with instances of `ConnectorObject` class.
 Confusingly enough these `ConnectorObject` instances represent *objects on the resource*: accounts, groups, roles, privileges, organizational units and so on.
-The `ConnectorObject` class contains a set of `Attribute`s. Each attribute has a name and one or more values.
+The `ConnectorObject` class contains a set of ``Attribute``s. Each `Attribute` has a name and one or more values.
 The values can be of several primitive types (see below).
 Each `ConnectorObject` also has its `ObjectClass`. The `ObjectClass` is essentially a string value that define the type of the resource object.
 It defines whether the object represents an account, group, role, organizational unit or anything else.
@@ -645,7 +645,9 @@ Resist the temptation to "normalize" the names to some common convention.
 MidPoint can easily do the mapping with (almost) any attribute names in (almost) any convention.
 
 * *type*: defines the type of the attribute: string, number, binary, etc.
-This is one of several selected Java data types:** `String`
+This is one of several selected Java data types:
+
+** `String`
 
 ** `long` and `Long`
 
@@ -686,7 +688,9 @@ But it may also be useful if the original attribute name is too "fancy" and desp
 E.g. if it contains national characters or something else that breaks ConnId or midPoint.
 In such a case this field can be used to store the original name.
 
-* *flags*: set of flags that define how the attribute should be used: `REQUIRED`: this is required attribute (not optional)
+* *flags*: set of flags that define how the attribute should be used: 
+
+** `REQUIRED`: this is required attribute (not optional)
 
 ** `MULTIVALUED`: attribute may have more than one value