documentation: fix sizes and markdown