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)

Link ¶

[link label](https://www.dataiku.com/)

Email link ¶

<[email protected]>

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 DSS object ¶

You can create a link a specific DSS object:

[[PROJECT_KEY.Wiki Article 1]]
(my dataset)[dataset:PROJECT_KEY.dataset_name]
(my model)[saved_model:PROJECT_KEY.model_id]
(my project)[project:PROJECT_KEY]

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:

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:

Advanced ¶

You can use HTML and CSS:

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