Visual Studio Online supports common Markdown conventions and Github-flavored extensions. Daring Fireball describes Markdown syntax, and the GitHub-flavored extensions are described at GitHub. Here are some additional pointers on creating Markdown for Visual Studio Online.
Create a link to another Markdown page
A link in is represented in Markdown like this: [text to display](link target). When linking to another Markdown page in the same Git or TFVC repository, the link target can be a relative path or an absolute path in the repository.
- Relative path:
[text to display](./target.md) - Absolute path in Git:
[text to display](/folder/target.md) - Absolute path in TFVC:
[text to display]($/project/folder/target.md)
Link to a heading in the page
When the Markdown file is rendered as HTML, all of the headings automatically get ids. For example, the heading for this section looks like this in the HTML file.
Link to a heading in the page
The Markdown for linking to a header looks like this: [text to display](#heading id).
A link to this section would look like this: [this section](#link-to-a-heading-in-the-page).
You can reference headings in another Markdown file, too, like this: [text to display](path to markdown#heading id).
Insert an image
Inserting an image is a lot like linking to another Markdown page.
 The path the the image file can be a relative path or the absolute path in Git or TVFC, just like the path to another Markdown file in a link.
Create a new page
You can create a new page by creating a link to a Markdown page that doesn't yet exist.
[new page](./newpage.md) When you click on that link, VSO will prompt you to create the Markdown file and commit it to your repository.