Fix Underscores in Headings

[jsjoeio]

Description

The goal of this is to propose a new format for part of the README, which will:

• improve readability
• fix issues with the autogenerated TOC

Screencast

Here's what it will look like:

[jsjoeio]

@johnnyreilly would love to get your thoughts on this before proceeding further.

Essentially, I propose going from this:
"

transpileOnly (boolean) (default=false)

"
to this:
"

transpileOnly

Type	Default Value
boolean	false

"

Just to be extra specific, I'm saying I want to propose having the type of value and default value in a table below the heading, instead of in the heading itself in parentheses.

I chose this solution because:
a) it doesn't seem like we could fix this with the CLI based on the docs for markdown-toc
b) I think this could improve readability potentially
c) it would fix the same issue #1044 brought up

[johnnyreilly]

Yeah I think this is great! Thanks for proposing it! Do you want to submit a full PR?

Thanks again!

[jsjoeio]

Woo! Definitely. Going to update then will mark ready for review when it's complete!

[jsjoeio]

Does this option have a default value? I didn't see one in the heading and wanted to ask.

If not, I can remove that column

[jsjoeio]

tagging @johnnyreilly just in case you didn't see this

[jsjoeio]

@johnnyreilly this is ready to go!

[johnnyreilly]

Nice one! I'll merge as soon as CI finishes doing it's thing. Thanks!