Como publicar no Medium

Algumas dicas que consegui anotar quando tentei publicar um artigo técnico no medium

#cms

O editor do Medium e o Medium como plataforma são bastante fáceis de usar, aqui eu mostro somente alguns pontos que me deram um pouco de trabalho.

Como colaborar em outro medium

Para publicar você precisa ser um editor/escritor do medium que você quer colaborar.

Para saber se você é um editor/escritor vá na página inicial do medium que quer publicar (por exemplo: https://blog.codeminer42.com/ ou https://medium.com/codeminer-42) e click em More information lá tem uma lista de editores/escritores, procure seu nome na lista :)

Como você está publicando em outro medium você terá que fazer um passo a mais, ao invés de Publish vá nos três pontinhos e selecione a publicação:

Três pontinhos -> Add to publication -> Selecione a publicação

Como colocar código

Medium não é legal para código 😠, use o gist, mas use um gist por trecho de código, pois mesmo selecionando o link do arquivo quando for inserir o embed ele pega o gist completo.

Testei com um repositório, mas também não funciona, não mostra nada só o link 😕

Uma outra forma é usar a combinação control+alt+6 (ou command+option+6 no Mac):

  1. Esteja numa linha em branco, depois tecle a combinação para o seu sistema operacional e depois digite o código ou;
  2. Digite o código, selecione e depois a combinação para o seu sistema operacional, mas cuidado: você terá que voltar e corrigir os usos de dois hífens (-) e aspas (“);

Outras dicas gerais de edição

  1. Coloque uma fotinha na publicação, para ficar mais bonitinho 😉
  2. Não exagere no negrito: quando você for ler um texto a primeira parte que você vê é o negrito. Ele fica bom no título e em outras partes, mas dentro de um texto dê preferência para usar itálico ou colocar o conteúdo entre aspas.

Check List para Publicar

  1. Revise o texto, procurando erros gramaticais e negrito desnecessário;
  2. Revise o conteúdo, i. e., a veracidade das informações, as referências e ausências de referências;
  3. Revise os blocos de código e certifique-se de que não tem nenhum  (hifen hifen) ou errado, eu recomendaria ainda tirar links de dentro de blocos de código, afinal ninguém gosta de copiar um comando para executar no terminal e acabar abrindo uma nova janela;
  4. Peça para alguém revisar o texto, você pode compartilhar o link do rascunho;
  5. Peça para alguém revisar o conteúdo, i. e., se você fez esse texto para "novatos” peça para um testar e tentar fazer funcionar, não precisar ser um teste minucioso, esse você mesmo deve fazer;
  6. Se estiver tudo ok, publique 🤘;
  7. Compartilhe;

Referências

Cover do post: Logos and Brand Guidelines – Designing Medium