> For the complete documentation index, see [llms.txt](https://docs.bdb.ai/data-science-lab-4/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-4/repo-sync-project/tabs-for-a-data-science-lab-project/tabs-for-tensorflow-and-pytorch-environment/notebook/notebook-page/.ipynb-cells/using-a-markdown-cell.md).

# Using a Markdown Cell

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

The Markdown cells are used to enter a description for the 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://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2Fhvp1nLyZaS5smaHCKNIU%2Fimage.png?alt=media&amp;token=e2f10a8a-b8a2-41e1-904d-70928e76fb06" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2FNiMgZ6qHzM7eN75AleAc%2Fimage.png?alt=media&amp;token=cea4ece3-48f2-4291-a47e-11b431cccdaf" 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://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2FWKTrtRKO2NFSWYmIIP8v%2Fimage.png?alt=media&amp;token=c7845edb-7120-4ccf-b067-dc9f3a6e4382" alt=""><figcaption><p><em><strong>Markdown cell with inserted text</strong></em></p></figcaption></figure>

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

<figure><img src="https://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2FYYJLKSHaGYyB1wNOHzZH%2Fimage.png?alt=media&amp;token=ed791e39-2941-4f05-abb9-38078a384498" 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://content.gitbook.com/content/1QeOywZjV1cHo55cMW8u/blobs/G0M224FxfRXe0xVtCDgu/image.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2Fp5KE9inp3VtaUGOhHVk7%2Fimage.png?alt=media&amp;token=796b28c7-1ca5-4129-bd1d-731ecca65625" 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://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2F4Wqxmurt6FBR5CEzwDbs%2Fimage.png?alt=media&amp;token=e86c4c00-49a9-4602-8095-09db4d1b1990" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2FP9L1eGHtDBKax9qSONHp%2Fimage.png?alt=media&amp;token=ca49b587-8334-4687-9b38-74f9d9c7dbf6" 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://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2FgIpAzyMb4bvgQyBMoNEt%2Fimage.png?alt=media&amp;token=afc21673-7aca-4e8c-97d2-6986a7ba2045" alt=""><figcaption><p><em><strong>Saving the Markdown updates</strong></em></p></figcaption></figure>

* The Markdown cell gets saved.
* Click the ***Save*** option for the file.
* A notification message appears, and the file gets saved with the inserted markdown.

<figure><img src="https://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2FOlS5seostzQHabOwSO8O%2Fimage.png?alt=media&amp;token=fabef201-a25d-42c7-87b7-e3b4d3758ed3" 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://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2FAwTy5fljSCVmUUOr9a6c%2Fimage.png?alt=media&amp;token=c604caff-2e42-4903-8877-351b815b5154" 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://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2FyY3NUEng8yv5eVr24Kx5%2Fimage.png?alt=media\&token=a15a4fdf-5dfe-4711-876c-288ca5544345)​

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

<figure><img src="https://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2FzmTIPweVraxNOyZ1tklH%2Fimage.png?alt=media&amp;token=ab7e60d1-f791-4f83-91a1-1aa63cb97241" alt=""><figcaption><p><em><strong>The 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://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2FSVOH5N0UaDX4g20GlmbP%2Fimage.png?alt=media&amp;token=061e7e7b-fcd7-4f32-9957-2a473b39f28d" alt=""><figcaption></figcaption></figure>

* Upload an image.

<figure><img src="https://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2FkublWAXGYJvdjQlqep4n%2Fimage.png?alt=media&amp;token=caa15a2d-26d7-4be5-b983-8cccbd0ee066" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2FCUBPjMZyfqWjr8MGjlab%2Fimage.png?alt=media&amp;token=8a08b248-7137-469f-b046-580fa079cdd2" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4082649235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1QeOywZjV1cHo55cMW8u%2Fuploads%2Fr05T7UmrvAlYVWwmLi9y%2Fimage.png?alt=media&amp;token=13af001d-fb11-46d4-b35c-b2ef154c7782" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
*<mark style="color:green;">Please Note:</mark> Refer the* [***Data Science Lab Quick Start Flow***](https://docs.bdb.ai/data-science-lab-4/data-science-lab-quick-start-flow) *page to get an overview of the **Data Science Lab** module in nutshell.*&#x20;
{% endhint %}
