Visão geral

Curso de escrita em Markdown

Aprenda Markdown prático para desenvolvedores: sintaxe básica, GitHub Flavored Markdown, templates de README e issue, visualização vs exportação HTML e fluxo de escrita confiável.

Este curso ensina Markdown como formato de escrita para desenvolvedores. Markdown não é um sistema de publicação por si só. É texto puro com sintaxe leve que GitHub, sites de docs, rastreadores de issues e muitos CMS sabem renderizar.

Você vai aprender a sintaxe que desenvolvedores usam com mais frequência, as extensões do GitHub Flavored Markdown que aparecem em README e issues, e como visualização e exportação HTML se encaixam em tarefas reais de documentação.

Para quem é este curso

  • Desenvolvedores que escrevem README, CHANGELOG ou docs de projeto
  • Engenheiros que redigem issues no GitHub, descrições de PR ou notas de RFC
  • Redatores técnicos que precisam de um formato rápido em texto puro
  • Quem move conteúdo entre repositórios, ferramentas de docs e campos de CMS

O que você vai aprender

  1. O que é Markdown e onde aparece no fluxo de trabalho de desenvolvedores
  2. Sintaxe central: títulos, listas, links, ênfase e código
  3. Tabelas GFM, blocos de código com cercas e listas de tarefas
  4. Estrutura de README e templates de issue
  5. Visualização vs exportação HTML sanitizada
  6. Um fluxo prático de revisão antes de publicar

Use a ferramenta relacionada Visualizar Markdown / Markdown para HTML enquanto lê. O objetivo não é só visualizar uma vez, mas escrever documentos que permaneçam legíveis no GitHub, em pipelines de docs e em caminhos de exportação HTML.