improved README.md
improved README.md

many language improvements
converted padded code blocks to fenced
added code types to fenced blocks
added headers in examples
expanded API notes

abner/tsd,Diullei/tsd,germ13/tsd,frankwallis/tsd,frankwallis/tsd,tboyce/tsd,DefinitelyTyped/tsd,perkastman/tsd,Diullei/tsd,IgorMinar/tsd,perkastman/tsd,abner/tsd,tboyce/tsd,IgorMinar/tsd,kyroskoh/tsd,DefinitelyTyped/tsd,nlunets/tsd,nlunets/tsd,nlunets/tsd,kyroskoh/tsd,germ13/tsd,kyroskoh/tsd,perkastman/tsd,DefinitelyTyped/tsd,tboyce/tsd,abner/tsd,frankwallis/tsd,germ13/tsd,Diullei/tsd,IgorMinar/tsd