diff --git a/packages/types/README.md b/packages/types/README.md
index 960c0ca540..dc872575ed 100644
--- a/packages/types/README.md
+++ b/packages/types/README.md
@@ -1,6 +1,6 @@
 # @plugnet/types
 
-Implementation of the types and their (de-)serialisation via SCALE codec.\
+Implementation of the types and their (de-)serialisation via SCALE codec.<br>
 On the Rust side, the codec types and primitive types are implemented via the [parity-codec](https://github.com/paritytech/parity-codec).
 
 
@@ -8,8 +8,8 @@ On the Rust side, the codec types and primitive types are implemented via the [p
 
 These are the base types of the codec. They are typically not used directly, but rather inherited from to create specific types. They are the building blocks for declaring custom types: 
 
-| | | |
-|-|-|-|
+| Type | Description |
+| - | - |
 | [[AbstractArray]] | Manages codec arrays. It is an extension to Array |
 | [[Base]] | A type extends the Base class, when it holds a value |
 | [[Compact]] | A compact length-encoding codec wrapper. Mostly used by other types to add length-prefixed encoding |
@@ -31,8 +31,8 @@ These are the base types of the codec. They are typically not used directly, but
 
 These primitive types are available:
 
-| | | |
-|-|-|-|
+| Type | Description |
+|-|-|
 | [[Bool]] | Representation for a boolean value in the system |
 | [[Bytes]] | A Bytes wrapper for `Vec<u8>` |
 | [[Data]] | A raw data structure. It is an encoding of a U8a without any length encoding |
@@ -65,8 +65,8 @@ These primitive types are available:
 
 These custom types implement specific types that are found as part of the Substrate core. They're all extensions of one of the codec types: 
 
-| | | |
-|-|-|-|
+| Type | Description |
+|-|-|
 | [[AccountId]] | A wrapper around an AccountId/PublicKey representation |
 | [[AccountIndex]] | A wrapper around an AccountIndex, which is a shortened, variable-length encoding for an Account |
 | [[AccountInfo]] | An Account information structure for contracts |
@@ -147,8 +147,8 @@ These custom types implement specific types that are found as part of the Substr
 
 These types are not used in the runtime, but are rather used in RPC results: 
 
-| | | |
-|-|-|-|
+| Type | Description |
+|-|-|
 | [[ChainProperties]] | Wraps the properties retrieved from the chain via the `system.properties` RPC call |
 | [[ExtrinsicStatus]] | An EnumType that indicates the status of the Extrinsic as been submitted |
 | [[Health]] | A system health indicator, reported back over RPC |