diff --git a/README.md b/README.md
index 9f536cb..21f8d44 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,54 @@
-# Osso de Ishango
+### Como isso aparece na tela?
+O Gitea vai desenhar uma **caixa amarela/branca** (estilo UML) com o título "Ficha_Tecnica" e uma lista organizada dentro, separada por linhas finas. É muito mais bonito que uma lista vertical simples e parece um "Cartão de Banco de Dados".
 
-> ### 🏛️ Ficha Técnica
-> * **Registro:** `RTJ-0042`
-> * **Coleção:** Matemática, África
-> * **Status:** Virtual (Original na Bélgica)
-> * **Arquivos:** `RTJ-0042.3d.glb`
+**Vantagens:**
+1.  **Digitação:** Você só escreve `Chave : Valor`. Zero barras `|`, zero alinhamento.
+2.  **Visual:** Cria um elemento gráfico destacado.
+3.  **Horizontalidade:** Se você quiser dividir em dois blocos lado a lado, o Mermaid permite!
 
-## Análise
-O resto do texto normal aqui...
\ No newline at end of file
+---
+
+### Quer dividir em colunas? (Visualização Horizontal)
+
+Se você quer ver os dados de "Identidade" de um lado e "Arquivos" do outro, use este código:
+
+```markdown
+```mermaid
+classDiagram
+    direction LR
+    %% Isso cria uma seta invisível para forçar a horizontalidade
+    Identidade --|> Arquivos : contem
+    
+    class Identidade {
+       ID : RTJ-0042
+       Origem : Congo
+       Material : Osso
+    }
+    
+    class Arquivos {
+       3D : .glb
+       Foto : .jpg
+       Licenca : CC-BY
+    }
+
+
+**O Resultado:** Dois cartões lado a lado.
+
+### Como o Python lê isso?
+É trivial. O Python ignora que é um diagrama e lê o texto dentro do bloco `mermaid`.
+
+```python
+import re
+
+def ler_ficha_mermaid(caminho):
+    with open(caminho, 'r') as f:
+        texto = f.read()
+    
+    # Procura por linhas com "Palavra : Valor" dentro do bloco mermaid
+    dados = {}
+    for linha in texto.splitlines():
+        if ":" in linha and "class" not in linha and "mermaid" not in linha:
+            chave, valor = linha.split(":", 1)
+            dados[chave.strip()] = valor.strip()
+    
+    return dados
\ No newline at end of file