lua_api.txt: Various fixes and improvements (#7638)

Improve item types descriptions.
Add replacements field to fuel definition.
Shorten two headers.
Markdown fixes.
Remove extra example.

Add blank lines after headings.

Linkify section references.
Bracketed section names can be linked when compiled to HTML.