documentation: fixup maruku errors & warnings
fixup markdown errors in manual