Better github markdown, comment on limitations