styleguide.md

Markdown Style Guide

Headings

# Heading h1
## Heading h2
### Heading h3
#### Heading h4
##### Heading h5
###### Heading h6

Note: h1 - h4 items will be automatically added to the Table of Contents.

Emphasis

Italics

Wrap text with a single _ for Italic text:

This is _italic text_.

Bold

Wrap text with double ** for Bold text:

This is **bold text**.

Strikethrough

Wrap text with double ~~ for strikethrough text:

This is ~~strikethrough~~ text.

Links

Wrap the title in square brackets [title] immediately followed by the URL in (https://example.com):

[WordPress](https://wordpress.org/)

Blockquotes

Use > for blockquotes, double >> to further indent:

> Blockquote
>> Indented Blockquote

Lists

Unordered Lists

Use - for unordereed lists, and intent two spaces for list subitems:

- List
  - List
- List
- List

Ordered Lists

Use numbered items followed by a `.:

1. One
2. Two
3. Three

Horizontal Rules

Use --- for a horizontal rules:

---

Tables

| A     | B     |
| ----- | ----- |
| Alpha | Bravo |

Example Code

Inline Code

Wrap inline code with ``` backticks:

This is `inline code` wrapped with backticks

When documenting an example, use the markdown \`\ code block to demarcate the beginning and end of the code sample:

Note: Full support for fenced code blocks is not yet implemented for the handbooks, to workaround this see the shortcodes section below:

Fenced Code Blocks

Javascript

var foo = function (bar) {
  return bar++;
};

console.log(foo(5));

CSS & SCSS

foo {
  padding: 5px;
  margin-right: 3px;
}

.bar {
  background-color: #f00;
}

PHP

$array = array(
    \"foo\" => \"bar\",
    \"bar\" => \"foo\",
);

This is _italic text_. This is **bold text**.

Shortcodes

Javascript

Wrap multiline Javascript code in [javascript] and [/javascript] each on their own line.

CSS & SCSS

Wrap multiline CSS & SCSS code in [css] and [/css] each on their own line.

PHP

Wrap multiline PHP code in [php] and [/php] each on their own line.

Markdown

Wrap multiline Markdown code in [md] and [/md] each on their own line.

Note: The [md] shortcode is also not currently supported.