# Create

This command displays prompts to create your own badge.

To start, run:

```sh
mdb create
```

then follow the prompts that follow. 

In the below guide, we will create a custom GitHub badge which links to the mdbadges-cli repository.

{% hint style="info" %}
Yellow text is the area that your answers to the prompts will fill out.
{% endhint %}

## Prompts

### **Alt Text** 

This is the text enclosed within the first square brackets.

In our example, this is `[![`<mark style="color:yellow;">`mdbadges-cli`</mark>**`]`**`...`

***

### **Text On Badge**&#x20;

This is the actual text that will be shown on the badge image.

In our example, we enter <mark style="color:yellow;">mdbadges-cli</mark> within the prompt, so this becomes `https://img.shields.io/badge/`<mark style="color:yellow;">`mdbadges-cli`</mark>`-%...` in the URL.

***

### H**exadecimal value**&#x20;

This is the hex color for the background of the badge.&#x20;

In our example, this is `...mdbadges-cli-`<mark style="color:yellow;">`000000`</mark>`...`

***

### L**ogo**&#x20;

This is the logo that will be displayed on the badge, which is taken from [SimpleIcons](https://simpleicons.org).

In our example, this is `logo=`<mark style="color:yellow;">`github`</mark>`...`

***

### L**ogo Color**&#x20;

This is the color that will the logo will use on the badge.

In our example, this is `logoColor=`<mark style="color:yellow;">`white`</mark>`...`

***

### Style

This prompt will determine the style that the created badge will use.

There are 5 styles you can pick from to use in the badge. These include the following:

* `flat`
* `flat-square`
* `plastic`
* `social`
* `for-the-badge`

In our example, this will be `style=`<mark style="color:yellow;">`for-the-badge`</mark>`...`

***

### L**ink (Optional)**&#x20;

This is an **optional** prompt that will let you enter the link that the badge will redirect to when clicked.

* In our example, this is `...)](`<mark style="color:yellow;">`https://github.com/inttter/mdbadges-cli`</mark>`)`

***

If you have been following this guide, this is what the prompts should look like:

<figure><img src="https://2551305873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEdxx25BjokH2rQ4D19bk%2Fuploads%2F9DeXFqrFHqZ8fCSL1FgB%2Fimage.png?alt=media&#x26;token=301f5d6c-d187-4430-95c3-e1a053a516e4" alt=""><figcaption><p>The above guide as performed in the terminal.</p></figcaption></figure>

***

With those steps completed, you should have a badge that you can now use in either your Markdown or your HTML webpage. You can run this command again to create another new badge!

## Aliases

This command has **1** alias, which is as follows:

* `generate`


---

# 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://inttter.gitbook.io/mdbcli/commands/create.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.