Authoring extensions
Install and use these extensions to write, validate, tag, and inspect Experience League content. Each one supports a different part of the authoring workflow, so use the right one for the task.
Where to find extensions
Learn the purpose of each extension and where to find them.
The following sections describe these extensions in more detail.
AdobeDocs Chrome extension adobedocs-chrome-extension
Purpose. Use the AdobeDocs Chrome extension to inspect a published Experience League page without leaving your browser. The extension lets you:
- Open the source file of the current page in the browser or in Visual Studio Code.
- View basic doc details.
- View all page metadata.
- View page analytics.
- Interact with video content (for tutorial authors).
Install the extension
-
Open a Chromium-based browser such as Chrome, Vivaldi, or Edge.
-
Go to this link directly in the Chrome Web Store:
https://chrome.google.com/webstore/detail/adobedocs-metadata/likkkalbnnlnmneamhdhofdglodgmgjc
This extension is not public on the Chrome Web Store, so you must use the direct link to access it. A search of the store will not find it.
-
Click Add to Chrome.
Use the extension
- Navigate to an Adobe Docs page such as https://experienceleague.adobe.com/docs/target-learn/tutorials/administration/set-up-account-preferences.html.
- Click the AdobeDocs extension icon
in the browser toolbar.
Specify advanced options
Specifying advanced options lets you open files in Visual Studio Code from the browser and view analytics.
-
Open extension settings.
-
Specify the following information:
- File system path of cloned Git repos. Example:
/users/<username>/documents/github - Analytics API key:
everyoneYdv22Cxkw4jgfWfd6th - Analytics duration (such as 30 days)
- File system path of cloned Git repos. Example:
Adobe Markdown Authoring adobe-markdown-authoring
Purpose. Use the Adobe Markdown Authoring extension to write and format Markdown content in Visual Studio Code. This extension pack adds:
- Preview. Click the Preview icon to view a reasonably close rendering of Adobe Markdown syntax.
- Shortcuts. Right-click in the document area to view available keyboard shortcuts. You can edit these shortcuts or create your own. See Keyboard shortcuts for Visual Studio Code.
- Validation. Most Adobe syntax rules are included in this add-on. If you add unsupported syntax, you’ll see squiggly underlines below the potentially offending text. Hover over the text to view the flagged problem.
Install the extension
-
Do the following:
- Uninstall any previous version of Adobe Markdown Authoring.
- Disable any custom preview extension you may have installed.
- Disable Markdown Shortcuts by mdickin if previously installed, to avoid duplicated shortcuts.
-
In the left nav, click the Extensions icon.
-
Search for adobe markdown authoring.
-
Click Adobe Markdown Authoring, and then click Install.
Known bugs and limitations
- The validation rules have not yet been updated to V2.
- Even when the rules are updated, there won’t be a perfect match between the plugin’s syntax rules and the validation rules. There’s almost always minor differences.
- The VSC preview is not a 100% representation of what the rendered page will look like. Preview is an imperfect tool.
To view or report issues, see Issues.
See also — RedPen Scoring, Visual Studio Code tips, Visual Studio Code add-ons we like.
Adobe ExL Authors adobe-exl-authors
Purpose. Use the Adobe ExL Authors extension (Version adobe-exl-authors-1.0.6) to tag articles and build playlists in Visual Studio Code. This extension adds:
- A Review Tags panel for adding, removing, and bulk-applying V2 taxonomy tags. See Add and review tags.
- A visual editor for building Experience League playlists. See Create playlists.
Install the extension
-
Download and install the Experience League extension. (Latest:
V1.0.6.vsix)- VSC: In Extensions, use Install via Install from VSIX….
-
To launch the tool in VSC, click the Adobe ExL Authors icon (the Adobe icon) in the activity bar.
If you have questions or concerns when using the extension, reach out to the exl-playlists Slack channel.
See also — Add and review tags, Create playlists.