Add Markdown to a dashboard
VSTS | TFS 2018 | TFS 2017 | TFS 2015.1-2015.3
Use the Markdown widget to support your team and stakeholders by adding information such as:
- Team goals
- Provide links to team backlogs or boards, metrics, or other items located in a network share such as a OneNote, SharePoint site or wiki pages
- Important dates or target deadlines
Here's an example:
Connect to the web portal for your team project
Open a browser window and click the Dashboards hub. If you haven't been added as a team member, get added now.
If you don't see the team or team project you want, click the project icon to browse all team projects and teams.
Add the markdown widget to a dashboard
Click to modify a dashboard.
If you need to add a dashboard, see Add and manage dashboards.
Click to open the widget catalog.
Drag the Markdown widget onto the dashboard where you want it located.
Click the gear icon to open the configuration dialog for the widget.
To edit a markdown widget, you may need to be a team admin, a member of the Project Administrators group, or be granted permissions. To learn more, see (../report/dashboard-permissions.md).
Adjust the widget size as needed to fit the contents of the markdown you'll enter. The largest size is 10 tiles wide by 10 tiles tall. You can always adjust this later.
Enter the text and markdown syntax into the configuration the configuration dialog. For supported syntax, see Syntax guidance for Markdown files, widgets, wikis, and pull request comments.
Here we show some simple text with a bulleted list of four links
To link to a wiki page, repository file, hub, or page within the team project, use this format:
This renders the following widget:
Links to documents on file shares using
file://are not supported on VSTS or TFS 2017.1 and later versions. This restriction has been implemented for security purposes.
Optionally, you can choose to point to a file in your repository.
If you haven't closed the widget catalog yet, do that now.
If you want to reposition the markdown widget or other widgets on the dashboard, do that now while you're still in dashboard edit mode.
When you're finished with your changes, click to exit dashboard editing.