Markdown Syntax Under Consideration

Wish list of syntax that we want to support in the next phase.

Full extensions

List of full extensions.

Definition Lists

Under considerations - not yet implemented

Frog
An amphibious green creature. Likes flies.

Buttons

Under considerations - not yet implemented

Previous Article
Next Article

JIRA 634

> [!div class="nextstepaction"]
> [button text](link to topic)

https://docs.microsoft.com/en-us/contribute/markdown-reference#next-step-action

Columns

Under considerations - not yet implemented

In Microsoft docs, the columns Markdown extension gives authors the ability to add column-based content layouts that are more flexible and powerful than basic Markdown tables, which are only suited for true tabular data. You can add up to four columns, and use the optional span attribute to merge two or more columns.

https://docs.microsoft.com/en-us/contribute/markdown-reference#columns

Details (Expand/Collapse)

Under considerations - not yet implemented

HTML: <details>

Accordion

Includes

Under considerations - not yet implemented

Include shared snippets (inline):

JIRA 375

Text before [!INCLUDE [<title>](<filepath>)] and after.

Or shared file (block):

JIRA 374

[!INCLUDE [<title>](<filepath>)]

Line breaks in markdown

Under considerations - not yet implemented

Line breaks for extra space/spacing

Task List

Under considerations - not yet implemented

- [x] Set up Jersey Shore recording
- [x] Buy donuts with sprinkles
- [x] Take nap
- [ ] Wash ferret

Selectors or Page tabs

Under considerations - not yet implemented

Allows users to select among multiple options for similar content, such as viewing operating system options.

GitBook uses code tabs:

https://github.com/GitbookIO/plugin-codetabs

Microsoft uses selectors:

https://docs.microsoft.com/en-us/contribute/markdown-reference#selectors

Subscript and superscript

Under considerations - not yet implemented

H<sub>2</sub>O

Property additions

We’re considering support for the following flags to extend supported syntax.

Code blocks line numbering and text wrap

Under consideration - not yet implemented

Images

Under consideration - not yet implemented

Hover text

![alt text](assets/logo.png)

JIRA 181

Size

![alt text](assets/logo.png){#width="140"}

JIRA 195

Under considerations - not yet implemented

[Text](https://www.adobe.com){#opennewtab="yes"}

JIRA 267

Tables

Under considerations - not yet implemented

Support alignment (|:---:|)?

Support iframes? Spans? TBD

On this page