Learn Authoring Pack
The Learn Authoring Pack provides a series of extensions to help learn.microsoft.com authors work better and more efficiently. You can read more about all of the Learn Authoring Pack features here in the overview guide. The Learn Authoring Pack provides the following extensions to help author content for learn.microsoft.com:
How to use the Learn Markdown extension
To access the Learn Markdown Authoring menu, type ALT + M. You can click or use up/down arrows to select the function you want, or type to start filtering, then hit ENTER when the function you want is highlighted in the menu.
You can also access the Learn commands from the VS Code command palette by hitting F1 and typing to filter. All the Learn commands begin with "Learn".
Prerequisites and assumptions
To accurately insert relative links, images, and other embedded content with Learn Markdown, you must have your VS Code workspace scoped to the root of your cloned OPS repo. Some syntax supported by the extension, such as alerts and snippets, are custom Markdown for Docs, and will not render correctly unless published via Learn.
For more information about the Learn Markdown commands, see the Learn Markdown readme.
How to use Learn Images extension
To access the Learn Images menu, right click on a folder or individual image file. Select Compress all images in folder or Compress image from the context menu.
For more information about the Learn Images extension, see the Learn Images readme.
How to use Learn YAML extension
Intellisense is automatically triggered by CTRL + Space to get what you can type.
For more information about the Learn YAML commands, see the Learn YAML readme.
How to use Learn Preview extension
You can open Learn Preview by opening a markdown document and clicking on the preview button. One opens the preview in your current window, and the other opens the markdown preview to the side. Alternatively you can hit Alt + M and select
For more information about the Learn Preview commands, see the Learn Preview readme.
Learn Markdown keyboard shortcuts and toolbar
How to assign keyboard shortcuts
Default keyboard shortcuts are available for some commands, as noted in the table above. You can override them, or add shortcuts for other commands, using the VS Code keyboard shortcut mappings.
See Keybindings in the VS Code Learn for more information.
How to show the Markdown toolbar
Users of the pre-release version of the extension will notice that the authoring toolbar no longer appears at the bottom of the VS Code window when the Learn Markdown extension is installed. This is because the toolbar took up a lot of space on the VS Code status bar, and did not follow best practices for extension UX, so it is deprecated in the new extension. However, you can optionally show the toolbar by updating your VS Code settings.json file as follows: