> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usebruno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bru Markup Language

<Info>
  Bruno will continue to fully support `.bru` files. However, [OpenCollection YAML](/opencollection-yaml/overview) is now the recommended format for new collections. OpenCollection is an open specification by Bruno that uses the industry-standard YAML format, enabling seamless integration with existing tooling and workflows.
</Info>

Bru is a simple markup language that utilizes plain text files to document and organize information for your API requests.

The API requests in your collections are stored as plain text files using this language.

This allows you to save your API collections in a folder within your code repository, and use your preferred version control system to manage and share them with your team. Collaboration on your API collections can be done through pull requests, as the human-readable file format makes it easy for developers to understand the changes made to the API collection.

Below is a sample of a Bru file for a `GET` request with some query params

<img src="https://mintcdn.com/bruno-a6972042/lK4oxIJsFt1GYUhN/images/screenshots/github-collection.webp?fit=max&auto=format&n=lK4oxIJsFt1GYUhN&q=85&s=73469ebf3bb8f65fdc4528bbb564e012" alt="bru lang sample" width="1039" height="743" data-path="images/screenshots/github-collection.webp" />

You can checkout the sample repository which contains GitHub rest API collection [here](https://github.com/usebruno/github-rest-api-collection)

If you are wondering why we designed a DSL instead of just using JSON/YAML, you can checkout this [github discussion](https://github.com/usebruno/bruno/discussions/360)