Our Very Own Markdown

Current features report #1

You may have heard of Markdown. If you have, it is a good thing. It can create rich texts, like in Microsoft Word, easily and quickly. For those of you who do not know what it is, here is the introduction by its creator, John Gruber (of Daring Fireball):

http://daringfireball.net/projects/markdown/

So, we have Markdown. Precisely, Quire’s own flavored Markdown.

Follow these 3 steps to see a few examples:

Go to any task -> Add description or comment (or click on Edit) -> Click on the “?” mark

Voila! A pop-up of our markdown list:

Want to add emphasis? You can either use `*` (*wow!*) for italic, or two asterisks (**wow!**) for bold.

To create a list, add an asterisk and a space before your items. It is just like what you would do if you were using Word or Page, but easier and quicker.

Wait, there’s more!

Sometimes, words just are not enough. Thankfully, you can use emoji icons in the description and comment of a task. If you type a colon, a list of emoji will automatically show up:

Talk about being “expressive”!

Next is something you will definitely find useful.

When you want to refer someone to a particular task, just enter @username and then #taskname. All the tasks containing the letters you have typed will show up. Simply find the right one.

This way, there is no more copying and posting the URL of a task.

Now that you have seen what our Markdown can do, see the cheat sheet below and give it a go!

Markdown Cheat Sheet

HEADERS

Quire’s Markdown supports two styles of headers, Setext and Atx.

Setext-style headers use equal signs (for first-level headers) and dashes (for second-level headers). For example:

H1

==

H2

--

Atx-style headers use 1–6 number signs at the start of the line, followed by 1–6 header levels. For example:

# H1

## H2

### H3

#### H4

##### H5

###### H6

LINE BREAKS

To generate a new line, you press SHIFT+Enter.

HORIZONTAL RULES

You can produce a horizontal rule by typing 3 or more hyphens, asterisks or underscores, with space in between if you like:

***

* * *

- — -

— — — — — — — —

EMPHASIS

You use asterisks to indicate emphasis.

For italic, you use 1 asterisk. For example:

This is *important*.

For bold, you use 2 asterisks. For example:

This is **very important**.

For both italic and bold, you use 3 asterisks. For example:

This is ***extremely important***.

STRIKETHROUGHS

You can use two tildes at the start and the end of the text:

~~Delete text.~~

LISTS

Markdown supports ordered (numbered) and unordered (bulleted) lists.

Order list uses numbers and periods like:

1. step1

2. step2

3. step3

Unordered list like:

* item1

* item2

* item3

is the same as:

+ item1

+ item2

+ item3

and:

- item1

- item2

- item3

Each item may consist of multiple paragraphs. To add a paragraph in a list item, indent 4 spaces or 1 tab like this:

1. step1

I’m a paragraph.

2. step2

3. step3

LINKS

You use square brackets to delimit the text and round brackets for the link. For example,

This is a [Google link](https://www.google.com/)

Markdown also supports 3 variants of links. First is a title for your link:

[Google link with title](http://google.com/ “Google”)

Second is the reference-style link that uses second set of square brackets that contain an id you choose for the link:

I use [Google][id1] more than I use [Yahoo][id2].

Then, anywhere in the text, you define your link id:

The third is an automated Link. You can simply write down a link, Markdown will turn it into a clickable link:

IMAGES

Markdown supports two styles of images: inline and reference.

Inline image syntax looks like this:

![alt text](path/to/image.jpg)

![alt text](path/to/image.jpg “Title”)

You write down an exclamation mark, a set of square brackets containing an alt attribute text for the image, a second set of square brackets containing the URL or path to the image, and an optional title attribute enclosed in double quotes.

Reference image syntax looks like this:

![alt text][id]

[id]: url/to/image.jpg “Title”

In this style of writing, “id” is the name of a defined image reference, which is defined in the same way as link references.

BLOCKQUOTES

Blockquotes are indicated using “>” angle brackets.

> I’m part of a very long quote. But I’ll still be quoted properly when I wrap.

Also, blockquotes can rest in blockquotes by adding levels of angle brackets:

> I’m the first level of quote.

>> I’m the second level of quote.

> I’m back at the first level.

CODE

To indicate a span of code, wrap it with “`” backtick quotes. For example,

Use two asterisks `**` for bold.

To include backtick characters in a code, you use multiple backtick quotes and spaces — one after the opening and one before the closing — like this:

Use two asterisks `` `**` `` for bold.

CODE BLOCK

You can generate a code block by indenting 4 spaces or 1 tab:

I’m a normal paragraph.

I’m a code block.

I'm a normal paragraph.

Or type 3 backticks in the beginning and the end of the text like this:

I’m a normal paragraph.

```

I’m a code block.

```

I’m a normal paragraph.

Remember to break the line before and after the backticks.

SYNTAX HIGHLIGHTING

We take code block one step further by adding Syntax Highlighting.

For example, if you define CSS as your content language:

```css

h1 {

font-size: 2.5em;

font-weight: normal;

}

```

Or if you choose Javascript as your content language:

```javascript

var setArray = function(elems) {

this.length = 0;

push.apply(this, elems);

return this;

}

```

You will see that it displays text in different colors according to the content language you chose, making it easier for programmers and developers to read.

YOUTUBE VIDEOS

Youtube videos can be added if you add an image with a link to the video:

[![IMAGE ALT TEXT HERE](http://img.youtube.com/vi/YOUTUBE_VIDEO_ID_HERE/0.jpg)](http://www.youtube.com/watch?v=YOUTUBE_VIDEO_ID_HERE)

Please stay tuned for more to come!