Abra um ficheiro .md no seu Mace leia-o como no GitHub.

Como abrir ficheiros Markdown num Mac

Um duplo clique num ficheiro .md num Mac costuma abri-lo como texto simples, cheio de # e **. O DotMD abre-o como uma página.

1. Abra um ficheiro ou uma pasta

   Prima ⌘O e escolha uma pasta ou um ficheiro, ou arraste um do Finder para a janela do DotMD ou para o seu ícone no Dock. Uma pasta passa a ser o seu espaço de trabalho na barra lateral, e cada ficheiro que abre passa a ser um separador.

2. Torne o DotMD a app predefinida para ficheiros .md

   Na primeira vez que o DotMD arranca enquanto outra app abre ficheiros Markdown, pergunta Set DotMD as Default? Escolha Set as Default. Pode fazê-lo mais tarde em Settings → General → Default App, ou no Finder: selecione um ficheiro .md, prima ⌘I, escolha o DotMD em Abrir com e clique em Alterar todos….

3. Leia-o

   A página é mostrada formatada como no GitHub. Selecione e copie texto como em qualquer página web, e prima ⌘F para procurar texto na página.

A barra lateral lista as pastas e os ficheiros Markdown que adicionou, com o índice do ficheiro aberto por baixo. Pinned mantém no topo os ficheiros que usa muito, e Recent lista os últimos vinte que abriu. Nada é copiado nem movido: o DotMD lê os seus ficheiros onde estão.

Como criar um ficheiro .md no Mac

Um ficheiro .md é um ficheiro de texto simples cujo nome termina em .md. Sem aplicações extra: abra o TextEdit, prima ⇧⌘T para passar a texto simples, escreva e guarde como notes.md. Se o macOS juntar .txt ao nome, mude o nome do ficheiro no Finder.

No DotMD, prima ⌘N ou escolha + → New Empty File, indique um nome e uma pasta, e o novo ficheiro abre-se no editor com um título # Title (editar faz parte do DotMD Editor). + → New File from Clipboard transforma o texto copiado, por exemplo a resposta de um agente, num ficheiro.

O que é formatado: tabelas, código, diagramas Mermaid e fórmulas

• Texto: títulos, listas, listas de tarefas, citações, ligações e imagens.
• Tabelas e código com cores de sintaxe.
• Diagramas Mermaid. Um bloco de código marcado mermaid é desenhado como diagrama, no tema claro ou escuro conforme a página. Clique num para o ver grande e faça o gesto de pinça para ampliar até 8×.
• Fórmulas KaTeX. $E = mc^2$ dentro de uma linha, ou $$ … $$ numa linha própria.
• Destaques como > [!NOTE], secções recolhíveis e o bloco de propriedades no topo de um ficheiro, mostrado como um cartão.

Os diagramas e as fórmulas são desenhados no seu Mac, por isso funcionam offline.

Leia um README.md de qualquer repositório

Um README é um ficheiro Markdown, por isso abre-se como qualquer outro. Prima ⌘O e escolha o README.md, ou a pasta do repositório para ler também a sua documentação. Títulos, tabelas, código, listas de tarefas e diagramas Mermaid são desenhados, as fórmulas também, e os emblemas e outras imagens da web aparecem. Ler é grátis.

Leia com conforto

O menu Aa define o tipo de letra (System, Serif ou Monospaced), a largura, o espaçamento entre linhas e o tema: Automatic, Light, Sepia ou Dark. Para textos longos, experimente Serif, Narrow, Relaxed e Sepia. A escolha fica memorizada.

⌘= e ⌘- ampliam e reduzem em passos de 10%. Uma linha azul fina no topo e a percentagem na barra de estado mostram quanto já leu, e o índice na barra lateral salta para qualquer título. Uma ligação para outro ficheiro .md abre-o no DotMD.

Quick Look no Finder

Selecione um ficheiro .md no Finder e prima a barra de espaço. A pré-visualização é parecida com o modo de leitura do DotMD, com tabelas, destaques, diagramas e fórmulas. Passa a funcionar depois de abrir o DotMD uma vez.

O Quick Look só pode ler o próprio ficheiro, por isso as imagens guardadas ao lado dele aparecem como um pequeno marcador; prima Open with DotMD para ver a página completa. Se aparecer a pré-visualização de outra app, confirme que o DotMD está ativado em Definições do Sistema → Geral → Início de sessão e extensões (macOS 15 ou posterior) ou Definições do Sistema → Privacidade e segurança → Extensões → Vista rápida (macOS 14).

O DotMD abre ficheiros com as extensões .md, .markdown, .mdown, .mkd, .mkdn, .mdx e .txt.

Perguntas sobre ler Markdown no Mac

Mais perguntas