> For the complete documentation index, see [llms.txt](https://docs.bdb.ai/data-science-lab-5/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bdb.ai/data-science-lab-5/data-science-notebook/.ipynb-file-cells/using-a-markdown-cell.md).

# Using a Markdown Cell

This page describes steps to use the text cells of the Data Science Notebook.

The Markdown cells are used to enter a description, links, images, headings, and text with Bold or Italics effect to a Data Science Notebook. They are formatted using a simple markup language called Markdown. The Markdown cell contains a toolbar to assist with editing.

## Inserting a Markdown Cell <a href="#inserting-a-markdown-cell" id="inserting-a-markdown-cell"></a>

* Navigate to a .ipynb file.
* Use the ***Add pre-cell*** icon to insert a new code cell to the file.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2F6bt23bV9lW3vrsseHJZY%2Fimage.png?alt=media&amp;token=c0aeacd3-79b0-48b6-918b-06ea4a4a5337" alt=""><figcaption></figcaption></figure>

OR

* Click the ***+Markdown*** option that appears below the code cell.
* The ***Markdown*** cell appears below to insert Markdown into the Notebook.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2F7OvyENALfNZ1e2fhbdEZ%2Fimage.png?alt=media&amp;token=9320c4e7-0413-441b-a782-b414de3aa745" alt=""><figcaption></figcaption></figure>

* Choose an action from the toolbar.
* It gets added to the left side of the Markdown cell.
* The right-side Markdown space displays the text with the applied effect.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2FKmKotbX2pWBH3m3t2zln%2Fimage.png?alt=media&amp;token=9842642a-2a48-49fe-850f-74ed0ae003ef" alt=""><figcaption><p><em><strong>Markdown cell  with inserted text</strong></em></p></figcaption></figure>

* The image displays a few actions from the toolbar (such as Bold, Italic, Heading, and link) applied to the ***Markdown*** text.
* Click the ***Save*** option.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2FQrUIoxICFqryCEHwBrko%2Fimage.png?alt=media&amp;token=566ef70b-8235-47a8-bcac-5d23b8e77d0f" alt=""><figcaption><p><em><strong>Saving the inserted text inside a Markdown cell</strong></em></p></figcaption></figure>

* The Markdown cell with inserted effect gets saved and the Markdown display gets changed displaying the text with saved effects on the left side (as shown in the given image).

{% hint style="info" %}
*<mark style="color:green;">Please Note:</mark> A Code cell gets added below the saved Markdown cell.*
{% endhint %}

* The user can click the ***Save*** option provided for the Notebook to save the update in the Notebook (after the Markdown cell has been added to it).

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2FXqOoDxSYh9puNWxIUNhn%2Fimage.png?alt=media&amp;token=0cc3e508-0dd4-4549-822a-2e8855cfec7f" alt=""><figcaption></figcaption></figure>

* The Notebook gets updated and the same gets communicated through a notification message.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2FIYFX3QH5RynWKqd3pKay%2Fimage.png?alt=media&amp;token=c9dbea4f-33ad-41ac-bd9f-fa9131aa479b" alt=""><figcaption></figcaption></figure>

## **Editing a Markdown Cell** <a href="#editing-a-markdown-cell" id="editing-a-markdown-cell"></a>

* Use the double clicks on a saved Markdown cell.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2FiVOSXGYvN8tuyIDx5Lr5%2Fimage.png?alt=media&amp;token=693b55ef-5eff-4325-af8e-25361e8fd6e0" alt=""><figcaption></figcaption></figure>

* The Markdown cell opens in the editable format to edit it.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2FxDESChQC5UB8NfQGvlGZ%2Fimage.png?alt=media&amp;token=9a289f4d-3761-41bd-b846-368fc4498015" alt=""><figcaption><p><em><strong>the</strong></em> <em><strong>Markdown cell opens in the editable format</strong></em></p></figcaption></figure>

* Modify the text inside the Markdown cell.
* Click the ***Save*** option to update the edited Markdown in the Notebook.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2FTpvjTI3TkaX2PBMzPwFp%2Fimage.png?alt=media&amp;token=1ca44523-129f-49e1-aab4-b9eecbb4bb28" alt=""><figcaption><p><em><strong>Saving the Markdown updates</strong></em></p></figcaption></figure>

* Click the ***Save*** option for the file.
* A notification message appears.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2FaiMMBb4SmDPzbduARA0p%2Fimage.png?alt=media&amp;token=27be3464-995f-4fd2-b46e-a45b2df82ae5" alt=""><figcaption></figcaption></figure>

* The file gets saved with the Markdown cell.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2FAHVjDot929i5ILu2uaqm%2Fimage.png?alt=media&amp;token=55401c6c-8d4b-41dc-ab6e-99ccf5387dc3" alt=""><figcaption></figcaption></figure>

## **Deleting a Markdown Cell** <a href="#deleting-a-markdown-cell" id="deleting-a-markdown-cell"></a>

* Click the ***Delete markdown*** icon for a saved Markdown cell.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2Fu90D1amHZRrUxPxcHh9G%2Fimage.png?alt=media&amp;token=08ba18cd-59aa-42e1-8c37-a49202c2fc85" alt=""><figcaption><p><em><strong>Delete markdown icon for the Markdown cell</strong></em></p></figcaption></figure>

* The ***Delete Cell*** dialog box opens.
* Click the ***Yes*** option.

&#x20;       ![](https://content.gitbook.com/content/z33KQNYQvBTgQKJBgwTz/blobs/rAzfjkXLg55VxZdssibB/image.png)​

* The selected Markdown gets removed and the same gets communicated by a notification message.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2F8XdrsQWBAErDciNfUubO%2Fimage.png?alt=media&amp;token=73ce7259-d646-450f-85ce-90425c9c1a3a" alt=""><figcaption><p><em><strong>The selected Markdown cell gets deleted</strong></em></p></figcaption></figure>

## Uploading an Image in the Markdown

* Navigate to a .ipynb file inside an activated Project.
* Access a ***Markdown*** cell.
* Click the ***Upload*** icon.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2FX1vQH3JWaeWoWsChN6OF%2Fimage.png?alt=media&amp;token=940d0114-350f-40e0-95c8-19596a4b25be" alt=""><figcaption></figcaption></figure>

* Upload an image.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2FEi8Xk6PVsJAjZjIYB0dY%2Fimage.png?alt=media&amp;token=2ad0b443-2d08-4e2b-a031-fe356c33beb3" alt=""><figcaption></figcaption></figure>

* The image gets uploaded to the markdown cell.
* Click the ***Save*** icon.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2FqNL2ZzkzsZEuceHt9FC8%2Fimage.png?alt=media&amp;token=5b2fb9cc-9eae-4a16-8075-b77ff4138f2c" alt=""><figcaption></figcaption></figure>

* The markdown cell gets saved the uploaded image appears in the View mode of the markdown.

<figure><img src="https://3817372244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz33KQNYQvBTgQKJBgwTz%2Fuploads%2Fp1jAtstKePR9Wi09fD1g%2Fimage.png?alt=media&amp;token=c2186301-17bb-42d3-b379-f6bd3ca0f57f" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
*<mark style="color:green;">Please Note:</mark> Do not forget to click the **Save** icon for the Data Science Notebook to save the markdown updates in the .ipynb file.*
{% endhint %}
