# Using a Markdown Cell

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>

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

![](https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2F1QMy5qBN3M5fRXVCogKy%2Fimage.png?alt=media\&token=1aa9fd9f-f983-471b-ad3e-0850e0e205a6)

* 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://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FLs7fLtaL2ldG9oxtIs9D%2Fimage.png?alt=media&#x26;token=b1d4041e-ba86-40c2-bcee-4daa914504c7" alt=""><figcaption><p>Markdown text when an action is applied</p></figcaption></figure>

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

<figure><img src="https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2F2Zhv86jYIi4sEw2LlVGl%2Fimage.png?alt=media&#x26;token=4d6f1887-15ab-4580-a7ee-cd4a5ca5297b" alt=""><figcaption></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).

<figure><img src="https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FAVdaTVkZvOCB150NXMyO%2Fimage.png?alt=media&#x26;token=c5bc1e69-1cda-45f0-85ed-88ca040a17b0" alt=""><figcaption><p>Saved Markdown cell</p></figcaption></figure>

* 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://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FTpJ7iprUjYtV6p2M8aKT%2Fimage.png?alt=media&#x26;token=b37a2725-8c39-4bf3-8346-88691171aff6" alt=""><figcaption><p>Saving the Notebook</p></figcaption></figure>

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

<figure><img src="https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FF6Z0xvQjwKe6t3iqSjoA%2Fimage.png?alt=media&#x26;token=b4771996-6425-4ebc-8f62-1083e3779d48" alt=""><figcaption><p>Notification message after the Notebook gets saved</p></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://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2F4JDjKFAXeqGz0ZJclNg7%2Fimage.png?alt=media&#x26;token=7eac6612-3bf7-4360-989a-f7d1416d780b" alt=""><figcaption><p>Double Clicks on the Markdown cell</p></figcaption></figure>

* The Markdown cell opens in the editable format to edit it.
* Click the ***Save*** option to update the edited Markdown in the Notebook.

<figure><img src="https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2F8aOoTcv5XYxjc2iJFdIY%2Fimage.png?alt=media&#x26;token=ea1e5c3f-b105-40ba-a7e3-8eba7d09f2f7" alt=""><figcaption><p>Save the Markdown updates</p></figcaption></figure>

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

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

<figure><img src="https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FxIa5QinmfKqZ8JxRUPF8%2Fimage.png?alt=media&#x26;token=136fa075-4bf7-46d7-9a85-d90e9ffc239b" alt=""><figcaption><p>The Delete Cell icon for the Markdown cell</p></figcaption></figure>

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

![](https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FHELnzhgPM2PqOcnPBkeZ%2Fimage.png?alt=media\&token=cbe70911-f532-409a-9d1a-b2d65ba8131a)​

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

<figure><img src="https://859511478-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGDmsjfjJBNqow7Fo97cO%2Fuploads%2FPVRXjvcGhmckNAdd559W%2Fimage.png?alt=media&#x26;token=9623c5b2-cbf1-4093-8662-8f54d4b35cec" alt=""><figcaption><p>The Markdown cell gets deleted</p></figcaption></figure>

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bdb.ai/data-science-lab/project/tabs-for-a-data-science-lab-project/tabs-for-pyspark-environment/notebook/notebook-page/notebook-cells/using-a-markdown-cell.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
