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.
Formatting¶
You can have **bold text** and _italic text_
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)
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: