Skip to main content

​
Como Usar Mintlify para Criar seu Blog

O Mintlify é uma plataforma incrível para criar documentação e blogs com uma aparência profissional. Neste post, vou compartilhar como você pode usar o Mintlify para criar seu próprio blog.

​
O que é Mintlify?

Mintlify é uma plataforma de documentação moderna que permite criar sites bonitos usando arquivos MDX (Markdown + React). É perfeita para:
  • Documentação de projetos
  • Blogs pessoais ou corporativos
  • Bases de conhecimento
  • Wikis de equipe

​
Primeiros Passos

​
1. Instalação

Primeiro, instale a CLI do Mintlify: 
npm i -g mint

​
2. Estrutura Básica

A estrutura de um projeto Mintlify é simples: 
/
├── docs.json          # Configuração principal
├── index.mdx          # Página inicial
├── blog/              # Posts do blog
│   ├── post1.mdx
│   └── post2.mdx
└── images/            # Imagens e assets

​
3. Configurando o docs.json

O arquivo docs.json é o coração da configuração: 
{
  "$schema": "https://mintlify.com/docs.json",
  "name": "Meu Blog",
  "theme": "mint",
  "colors": {
    "primary": "#3B82F6",
    "light": "#60A5FA",
    "dark": "#1E40AF"
  }
}

​
Escrevendo Posts

Os posts são escritos em MDX, que combina Markdown com componentes React: 
---
title: "Título do Post"
description: "Descrição breve"
date: "2025-11-05"
---

# Seu Conteúdo Aqui

Use **markdown** normalmente!

<Card title="Componentes React" icon="react">
  Você também pode usar componentes!
</Card>

​
Componentes Úteis

O Mintlify oferece vários componentes prontos: 
<Card title="Título" icon="star">
  Conteúdo do card
</Card>

​
Dicas de Personalização

​
Cores e Tema

Personalize as cores no docs.json: 
"colors": {
  "primary": "#sua-cor-primaria",
  "light": "#sua-cor-clara",
  "dark": "#sua-cor-escura"
}
Adicione seus logos: 
"logo": {
  "light": "/logo/light.svg",
  "dark": "/logo/dark.svg"
}
Organize sua navegação por categorias: 
"navigation": {
  "tabs": [
    {
      "tab": "Blog",
      "groups": [
        {
          "group": "Posts Recentes",
          "pages": ["blog/post1", "blog/post2"]
        }
      ]
    }
  ]
}

​
Deploy

O Mintlify oferece deploy automático:
  1. Conecte seu repositório GitHub
  2. Configure o webhook
  3. Cada push para main atualiza automaticamente

​
Conclusão

O Mintlify é uma excelente escolha para quem quer um blog profissional sem complicações. Com MDX, você tem a flexibilidade do Markdown e o poder dos componentes React.
Explore a documentação oficial para descobrir mais recursos!
Publicado em 04 de novembro de 2025