make footnotes render with check_markup and improve docs