> For the complete documentation index, see [llms.txt](https://cumbucadev.gitbook.io/github-essentials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cumbucadev.gitbook.io/github-essentials/dia-7/explorando-a-linguagem-de-marcacao-markdown.md).

# Explorando a Linguagem de Marcação Markdown

Markdown é a linguagem de marcação padrão utilizada pelo GitHub para criar e formatar documentos de texto na plataforma. Ela é leve, fácil de usar e foi projetada para permitir que você escreva e formate documentos com uma sintaxe simples e intuitiva. O Markdown combina a legibilidade de um texto puro com a capacidade de ser convertido para formatos mais sofisticados, como HTML, PDF, .doc, .docx e outros.

## Linguagens de Marcação

Linguagens de marcação, como o Markdown, são formas de organizar e formatar texto utilizando símbolos específicos. Elas permitem criar estilos como **negrito**, *itálico*, listas e links, sem a necessidade de editores visuais complexos. Quando um texto escrito em uma linguagem de marcação é processado por um programa compatível, ele é exibido de maneira formatada e visualmente atraente.

Você pode pensar nelas como "regras simples" para transformar texto em algo mais estruturado e estilizado.

Embora as linguagens de marcação e as linguagens de programação compartilhem a ideia de seguir uma sintaxe específica, elas têm propósitos bem diferentes:

**Linguagens de Marcação**:

* Usadas para organizar e formatar conteúdo textual.
* Exemplos: Markdown, HTML, XML.
* Não possuem lógica, como loops ou condições.

**Linguagens de Programação**:

* Usadas para criar aplicativos, resolver problemas e executar ações.
* Exemplos: Python, JavaScript, Ruby.
* Incluem lógica, estruturas de controle, e podem interagir com hardware e sistemas.

## **Como funciona**

Ao escrever um texto em Markdown e salvar o arquivo com a extensão `.md`, você está criando um documento que é simples de ler e organizar. Quando esse arquivo é enviado para o GitHub (ou outras plataformas compatíveis), ele é automaticamente convertido para um formato formatado, com títulos, listas, links e outros elementos estruturados. Isso permite que o conteúdo seja visualizado de forma clara e bonita, sem a necessidade de programas adicionais.

Exemplo de um texto utilizando a linguagem de marcação Markdown:

```markdown
# Meu Título  
Esse é um parágrafo.  
```

Exemplo de como esse texto é apresentado no GitHub:

<figure><img src="/files/1hfIXgwsS9UGYRV4OjhS" alt="Captura de tela do editor de texto do GitHub mostrando um arquivo README com o título &#x27;Meu Título&#x27; e um parágrafo de exemplo."><figcaption><p>Editor de texto do GitHub.</p></figcaption></figure>

Markdown é uma ferramenta poderosa para quem deseja criar conteúdo formatado sem complicações, especialmente em ambientes de desenvolvimento.&#x20;

## Mais sobre Markdown

Já tem um monte de conteúdo em português super detalhado sobre Markdown, então não precisamos reinventar a roda! Dê uma olhada nesses dois artigos para se preparar bem antes de partir para a parte prática.&#x20;

{% embed url="<https://markdown.net.br/introducao/>" %}

{% embed url="<https://docs.github.com/pt/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax>" %}

## Hora de Praticar

Agora que você já tem a teoria na bagagem, chegou o momento de colocar a mão na massa! Vamos praticar o que aprendemos até aqui com os seguintes tutoriais:

{% embed url="<https://markdown.net.br/sintaxe-basica/>" %}

{% embed url="<https://github.com/skills/communicate-using-markdown/tree/main>" %}

O segundo link é um tutorial em inglês, mas não se preocupe com o idioma – basta usar o tradutor do navegador, como mencionamos anteriormente na seção [Navegadores](https://github-essentials.cumbuca.dev/dia-4-prazer-github/idiomas-disponiveis#navegadores) da página [Idiomas Disponíveis](https://github-essentials.cumbuca.dev/dia-4-prazer-github/idiomas-disponiveis) do dia 4.

Assim, você consegue acompanhar tudo com facilidade, mesmo em inglês!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://cumbucadev.gitbook.io/github-essentials/dia-7/explorando-a-linguagem-de-marcacao-markdown.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.