Markdown allows you to write using a simple plain text format, which is converted to valid HTML for viewing on Qualified.
Paragraphs in Markdown are just one or more lines of consecutive text followed by one or more blank lines.
On July 2, an alien mothership entered Earth's orbit and deployed several dozen saucer-shaped "destroyer" spacecraft, each 15 miles (24 km) wide. On July 3, the Black Knights, a squadron of Marine Corps F/A-18 Hornets, participated in an assault on a destroyer near the city of Los Angeles.
You can create a heading by adding one or more
# symbols and a space before your heading text. The number of
# you use will determine the size of the heading, from one (largest) to six (smallest).
# The largest heading (an <h1> tag) ## The second largest heading (an <h2> tag) … ###### The 6th largest heading (an <h6> tag)
You can indicate blockquotes with a
> followed by a space. Multiple lines
> Everyday life is like programming, I guess. > If you love something you can put beauty into it. > - Donald Knuth
You can make text italic or bold.
*This text will be italic* so will _this_ **This text will be bold** as will __that__
Both bold and italic can use either a
* or an
_ around the text for styling. This allows you to combine both bold and italic if needed.
**Don't forget there's a _free lunch_ being served today!**
strike through a section of text by surrounding it with double
This response ~~is no longer relevant~~.
You can make an unordered list by typing either a
* or a
- then a space before each item.
* Cat * Dog * Fish - Red - Green - Blue
You can make an ordered list by typing a number followed by a
. then a space before each item.
1. Add dry ingredients 2. Add wet ingredients 3. Mix thoroughly
1and count up sequentially from there.
You can create nested lists by indenting each sublist by two, three, or four spaces.
1. Gather Supplies * Wood pieces * Nails 2. Assemble 1. Line items up * Align letters together 2. Hammer nails into place 3. Paint
Use single backticks (
` ) to format text in a special monospace format. Everything within the backticks appear as-is, with no other special formatting.
On line 3, `LaunchRocketship()` should be `**launch**Rocketship()`.
You can use triple backticks (
``` ) to format text as its own distinct block.
Check out this neat program I wrote: ``` x = 0 x = 2 + 2 // what is x ```
You can include the language of a block of code by tagging the block, with an optional starting line number:
If you are developing a multi-language challenge, and want to include language-specific examples, Qualified has a special extension for Markdown. Simply include multiple, tagged code examples in a row, and the correct one for the currently chosen language will show:
Language Targeted Section Blocks
Qualified has further extended the concept of Multi-language blocks to allow you to enclose entire sections of markdown within
if-not statements, similar to how Multi-language blocks work. These statements can target multiple languages at a time if you wish. Using this feature, you can selectively hide or show content based off of the active language, allowing you to manage your instructions for all languages and still target them directly as needed.
The following example illustrates if the text inside each block would be shown or not:
You can also include nested code blocks by using the alternative code fence syntax (~~~).
```as your top level fence for defining a block. We recommend always using
```for your top level blocks, so that its easier to identify nested blocks.
An additional extension that Qualified has added is the ability to wrap your markdown within alert blocks, which allow you to call out certain sections. The syntax is similar to using code fences, but you add a
% prefix before the alert type.
```%default A default light gray block. You can use markdown in here ## Header to show that you can use markdown inside of the alert ``` ```%info A blue info block ``` ```%warn A yellow warning/caution block ``` ```%danger A red block ```
You can create an inline link by wrapping link text in brackets (
[ ]), and then wrapping the link in parentheses (
For example, to create a hyperlink to http://www.qualified.io, with a link text that says, Visit Qualified!, you'd write this in Markdown:
If you want to expose a hyperlink directly, you can simply include it in the code, and it will be automatically linked:
Qualified's Markdown editors support drag-and-drop images. Simply drag a file in from your file system, or copy and paste a file into the editor, to have the image uploaded and inserted automatically.
You an also click on the link below the editor to open a file dialog to select your images that way.
Almost any image file format is supported, and will be converted automatically if necessary.
If you want to insert image references manually, the format is similar to links, but with an exclamation mark at the front, like so:
![Image Description]( )
The Image Description portion will be used as the tooltip or alternative text if the image is missing or for screen readers.
You can create tables by assembling a list of words and dividing them with hyphens
- (for the first row), and then separating each column with a pipe
First Header | Second Header ------------- | ------------- Content Cell | Content Cell Content Cell | Content Cell
For aesthetic purposes, you can also add extra pipes on the ends:
| First Header | Second Header | | ------------- | ------------- | | Content Cell | Content Cell | | Content Cell | Content Cell |
Note that the dashes at the top don't need to match the length of the header text exactly:
| Name | Description | | ------------- | ----------- | | Help | Display the help window.| | Close | Closes a window |
You can also include inline Markdown such as links, bold, italics, or strikethrough:
| Name | Description | | ------------- | ----------- | | Help | ~~Display the~~ help window.| | Close | _Closes_ a window |