Cosmo has a limited HTML feature set, and only a subset of Markdown features are supported. Here's what works and how to convert the stuff that doesn't work.
Supported Markdown Features
Headings
To create a heading, add one to six # symbols before your heading text. The number of # you use will determine the hierarchy level and typeface size of the heading. Note that h1 is typically reserved for the page title, so h2-h4 are recommended for article content.
# A first-level heading
## A second-level heading
### A third-level heading
#### A fourth-level heading
Bold
To make text bold, wrap it in double asterisks or double underscores.
**This text is bold**
__This is also bold__
Italic
To make text italic, wrap it in single asterisks or single underscores.
*This text is italic*
_This is also italic_
Links
To create a link, wrap the link text in brackets and the URL in parentheses. Links will automatically open in a new window.
[LinkedIn Learning](https://www.linkedin.com/learning)
Images
To add an image, use an exclamation mark followed by alt text in brackets and the image URL in parentheses. Images must be hosted on a server (data URIs are not supported).
Unordered Lists
To create an unordered (bulleted) list, add a dash, asterisk, or plus sign before each item. Indent items with two spaces to create nested lists.
- First item
- Second item
- Nested item
- Another nested item
- Third item
Ordered Lists
To create an ordered (numbered) list, add a number followed by a period before each item. Indent items with two spaces to create nested lists.
1. First item
2. Second item
1. Nested item
2. Another nested item
3. Third item
Inline Code
To denote inline code, wrap the text in single backticks.
Use the `print()` function to output text.
Code Blocks
To create a code block, wrap your code in triple backticks. You can optionally specify the language for syntax highlighting.
```
def hello():
print("Hello, World!")
```
Paragraphs
Regular text is automatically converted to paragraphs. Separate paragraphs with a blank line.
This is the first paragraph.
This is the second paragraph.
Line Breaks
To create a line break within a paragraph, end the line with two spaces.
This is the first line.
This is the second line (same paragraph).
Unsupported Features
The following Markdown features are not supported in Cosmo Text. Here's what to use instead:
Horizontal Rules
---
***
___
Fallback: No fallback available. Remove horizontal rules from your content.
Blockquotes
> This is a blockquote
Fallback: Use a paragraph with italicized text instead.
*"This is a blockquote styled as italic text."*
Tables
| Header 1 | Header 2 |
| -------- | -------- |
| Cell 1 | Cell 2 |
Fallback: Use a preformatted code block to preserve the table layout, or convert the table to an image.
Strikethrough
~~This text is struck through~~
Fallback: No fallback available. Remove strikethrough formatting or rephrase the content.
Task Lists
- [ ] Task one
- [x] Task two
Fallback: Use a standard unordered list instead.
- Task one (not completed)
- Task two (completed)
Footnotes
Here is a footnote reference[^1].
[^1]: This is the footnote content.
Fallback: No fallback available. Move footnote content directly into the main article text, either inline or as a parenthetical note.
Embedded Data URI Images
Fallback: Upload your image to a server and use a hosted URL instead.
