Documentation: fix multiple errors and warnings

Multiple files were badly formatted, which resulted in many
warnings. This made it harder to check for errors in newly
written documentation.

What's worse, badly formatted text resulted in butchered
output in generated html.

This patch fixes most of the errors, but alas, not all of
the errors can be fixed. Anyway, this should be way easier
to spot errors in newly written docs now.

Signed-off-by: Michał Łyszczek <michal.lyszczek@bofc.pl>

Documentation/platforms/risc-v/esp32c3/index.rst

@@ -123,7 +123,7 @@ LED_PWM      Yes
 SHA          Yes
 RSA          Yes
 CDC Console  Yes    Rev.3
-========== ======= =====
+=========== ======= =====
 
 Supported Boards
 ================