# Finding a Badge

**Arguments:** `[category] [badgeName]`

Finding commands involves laying out your command like this:

```
mdb [category] [badgeName]
```

As an example, if you wanted to find a badge for Discord, you can run the following command:

```bash
mdb social discord
```

In the case seen above, `social`  is the **category** which Discord is contained in, while `discord` is the definition name of the badge.

This will output the following in the terminal:

```markdown
Badge found:
[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?&logo=discord&logoColor=white)](#)
```

The badge will show up like this in Markdown: <img src="https://img.shields.io/badge/Discord-%235865F2.svg?&#x26;logo=discord&#x26;logoColor=white" alt="Discord" data-size="original">

{% hint style="info" %}
If you aren't sure that mdbadges-cli has the badge you're looking for, use `mdb search` to search for your badge across all categories.
{% endhint %}

***

## Handling multiple badges <a href="#auto-update" id="auto-update"></a>

You can also find more than one badge at the same time, as long as they are all within the **same** category as each other. This also supports the [additional options](#additional-options) for this command.

For example, to generate 3 badges for **Discord**, **GitHub** and **YouTube**, which are all from the **Social** category, run:

```sh
mdb social github discord youtube
```

This will output the following in the terminal:

```markdown
Badge found:
[![GitHub](https://img.shields.io/badge/GitHub-%23121011.svg?logo=github&logoColor=white)](#)

Badge found:
[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?&logo=discord&logoColor=white)](#)

Badge found:
[![YouTube](https://img.shields.io/badge/YouTube-%23FF0000.svg?logo=YouTube&logoColor=white)](#)
```

The badges will show up like this in Markdown: <img src="https://img.shields.io/badge/GitHub-%23121011.svg?logo=github&#x26;logoColor=white" alt="GitHub" data-size="original"> ![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?\&logo=discord\&logoColor=white) ![YouTube](https://img.shields.io/badge/YouTube-%23FF0000.svg?logo=YouTube\&logoColor=white)

***

## Additional Options

### `--style / -s`&#x20;

<mark style="color:yellow;">**Function**</mark>: Toggles the style of the badge.

There are 5 styles available to use with badges. These include the following:

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

To change the style of the badge, which is by default `flat` when no style is specified in the Shields.io URL, add this option after the command:

```sh
mdb social discord --style for-the-badge
```

This will output the following in the terminal:

```markdown
Badge found:
[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?&logo=discord&logoColor=white&style=for-the-badge)](#)
```

The badge will show up like this in Markdown: <img src="https://img.shields.io/badge/Discord-%235865F2.svg?&#x26;logo=discord&#x26;logoColor=white&#x26;style=for-the-badge" alt="Discord" data-size="line">

***

### `--link` <a href="#auto-update" id="auto-update"></a>

<mark style="color:yellow;">**Function**</mark>: Toggles whether a badge should link to another site.

Adding this option will ask you to enter a prompt with a link that you want to lead people to when they click on it:

```sh
mdb social discord --link
```

From here, enter the link you want to lead a user to when they click on the badge:

```markdown
│
◇  Enter your link here:
│  https://discord.gg/nextjs

Badge found:
[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?&logo=discord&logoColor=white)](https://discord.gg/nextjs)
```

{% hint style="info" %}
Using this option when finding multiple badges will prompt you to enter seperate links for each specified badge.
{% endhint %}

***

### `--html`

<mark style="color:yellow;">**Function**</mark>: Toggles the HTML version of a badge.

Getting the HTML version of a badge is also supported.&#x20;

Adding this option will output the HTML code as an `<img>` tag, and also surrounded by `<a>` tags if you use the `--link` option together with this option.

To get the HTML version of a badge, use the option after your command:

```sh
mdb social discord --html
```

This will output the following in the terminal:

```html
<img src="https://img.shields.io/badge/Discord-%235865F2.svg?&logo=discord&logoColor=white" alt="Discord">
```

You can now use this code in your HTML to display it on a webpage.


---

# 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/finding-a-badge.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.
