> For the complete documentation index, see [llms.txt](https://inttter.gitbook.io/mdbcli/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://inttter.gitbook.io/mdbcli/commands/create.md).

# 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="/files/ATNk4KezeWgNe2J64LWA" 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`