Markdown

DSS comes with editable text fields. It ensures to improve collaboration between users. They are:

  • The short and long descriptions of any DSS object (in the Summary tab)
  • Wiki articles of a project
  • Discussions on any DSS object (by using the Discussions button on the navbar)

All of these text fields support Markdown.

Definition

Markdown is an easy-to-use syntax that aims to prettify text by allowing to use pictures, to format text, to display advanced objects like tables, lists, etc.

For more information, please visit Wikipedia and this Cheatsheet

Syntax guide

Here’s an overview of Markdown syntax.

Headlines

# Title

## Subtitle

Formatting

You can have **bold text** and _italic text_

Lists

- element 1
- element 2
1. element 1 in numbered list
2. element 2 in numbered list

Image

![image label](https://upload.wikimedia.org/wikipedia/en/thumb/9/91/Dataiku_logo.png/250px-Dataiku_logo.png)

If the image is stored as an attachment to a wiki article, you can display it with:

![image label](PROJECT_KEY.attachment_id)

Blocks

> quoted text
> on two lines
```
# This is a code snippet
import os
print(os.name)
```

Table

| Name       | Hobby             | Pet         |
|------------|-------------------|-------------|
| Astrid     | :fries:           | :rat:       |
| Clément    | :computer:        | :cat2:      |
| Sonia      | :champagne:       | :chicken:   |
| Pierre     | :surfer:          | :palm_tree: |

Emoji

DSS Markdown comes with a list of emojis (use autocompletion by typing the character :):

:coffee: :soccer: :snowman:

Users

You can mention an user with its username (use autocompletion by typing the character @):

@admin

Link to article uploaded attachment

You can create a link to download an attachment to a wiki article:

[attachment label](PROJECT_KEY.attachment_id)

Formula (LaTeX)

You can insert mathematical formulas using the LaTeX syntax as a block:

```math
E = \frac{mc^2}{\sqrt{1-\frac{v^2}{c^2}}}
```

The above formula is rendered as:

../_images/formula-block.png

You can can also insert LaTeX-formatted formulas within paragraphs:

When $`a \ne 0`$, there are two solutions to $`ax^2 + bx + c = 0`$

The above paragraph is rendered as:

../_images/formula-inline.png

Advanced

You can use HTML and CSS:

<i class="icon-dkubird" />
<marquee direction="right">&lt;&gt;&lt;&nbsp;&hellip;</marquee>