doc: fix HTML validation errors in docs content

Fix AsciiDoc markup causing incorrect HTML output

Fix broken link and italic rendering caused by unescaped characters
in AsciiDoc sources.

Reviewed by: carlavilla
Approved by: carlavilla
Differential Revision: https://reviews.freebsd.org/D60042
PR: 297509