re #1 update api/index.md with markdown