Package Name (1.2.3)
Short package description; useful for quick one-liners when displaying information about it on various sites/contexts.
Normal Readme Stuff
Blah, blah blah. The order of readme sections doesn't matter: organize it however you like.
The parser would be looking for headers w/ specific titles (Dependencies, Development Dependencies, ???), and the first section only.
...and maybe more readme stuff goes here...
Some notes and ideas: