convert to markdown and add troubleshooting steps