Fix minor formatting issues in API reference

The tables in the API reference appear slightly too close to the content above them in some contexts, and asterisks should if possible always be on the same line as last word in the table entry.

`Code formatted text` make it look like the paragraph/sentence is indented (more so than it does on other websites).

I also wonder if the code formatted text should have a different background color when the entries are in a table?

Screenshot taken from https://constructs.dev/packages/@cloudcamp/aws-runtime/v/0.0.1/