docs: changes in markdown for readability

[msdolbey]

Signed-off-by: msdolbey [email protected]

This is a minor nit, but saw this and changed it on the README -
On main:

With changes:

markdown didn't like this when it was indented in without a list

[kaovilai]

Suggested change

	- made some markdown changes in the README (#xx, @msdolbey)
	- made some markdown changes in the README (#106, @msdolbey)

[blackpiglet]

Thanks.
Plugins don't use these changelog files to generate the release note, so I think it's OK to not change. I will manually create the release note for GA.

[codecov-commenter]

Codecov Report

Merging #106 (29cee0d) into main (4a46a41) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main     #106   +/-   ##
=======================================
  Coverage   21.36%   21.36%           
=======================================
  Files           3        3           
  Lines         482      482           
=======================================
  Hits          103      103           
  Misses        375      375           
  Partials        4        4           

[jglick]

There are more code block problems that are not fixed here. See #97.

[blackpiglet]

There are more code block problems that are not fixed here. See #97.

I put some comments in #97
My opinion is just fixing the blocks impacting the MarkDown display is enough, but open to other options.