Add section on markers.
Change top-level marker example and add extra ref.
Fix typo in --repeat option.
Mention setting PYTHONPATH for pytest.
Tweak mark-up a little.
Merge pull request #1039 from ximenesuk/more-markers

Add more detail on pytest markers