markdown parser wasn't picking up some of the indented places as code (notably the `rails s` step below). explicitly marking code blocks seemed preferable to me. plus, with the triple-backtick syntax, you can add syntax highlighting.