If you use angle brackets in text in your file (for example, to denote a placeholder), you need to manually encode the angle brackets. These alerts look like this on Microsoft Learn:ĭangerous certain consequences of an action. > Dangerous certain consequences of an action. > Negative potential consequences of an action. > Essential information required for user success. > Optional information to help a user be more successful. > Information the user should notice even if skimming. The following alert types are supported: > Multiple notes should never be next to each other in an article. If you need to use alerts, limit them to one or two per article.

It's better to put that info directly into the article text. Alerts (Note, Tip, Important, Caution, Warning)Īlerts are a Markdown extension to create block quotes that render on Microsoft Learn with colors and icons that indicate the significance of the content.Īvoid notes, tips, and important boxes. The Learn Authoring Pack provides editing tools and preview functionality that lets you see what your articles will look like when rendered on Microsoft Learn.

You can use any text editor to write Markdown, but we recommend Visual Studio Code with the Learn Authoring Pack. Microsoft Learn also supports custom Markdown extensions that provide richer content on the Microsoft Learn site. The Microsoft Learn platform supports CommonMark compliant Markdown parsed through the Markdig parsing engine.

Markdown is a lightweight markup language with plain text formatting syntax. This article provides an alphabetical reference for writing Markdown for Microsoft Learn.

Tab in macdown