markdown here Download - markdown here Download do código-fonte

markdown here

Outro código-fonte

v2.14.2

Baixar

Remarcação aqui

Visite o site.
Obtenha-o para o Chrome.
Obtenha-o para Firefox.
Obtenha-o para o Safari.
Compre para o Thunderbird.
Compre para o Opera.
Discuta e faça perguntas nas discussões do GitHub.

Markdown Aqui está uma extensão do Google Chrome, Firefox, Safari, Opera e Thunderbird que permite escrever e-mails ^† em Markdown ^‡ e renderizá-los antes de enviá-los. Ele também suporta realce de sintaxe (basta especificar o idioma em um bloco de código protegido).

Escrever e-mail com código é muito tedioso. Escrever Markdown com código é fácil. Eu me peguei escrevendo um e-mail em Markdown no editor do navegador GitHub e, em seguida, copiando a visualização para o e-mail. Este é um fluxo de trabalho bastante absurdo, então decidi criar uma ferramenta para escrever e renderizar Markdown direto no email.

Para descobrir o que pode ser feito com o Markdown no Markdown Here , confira o Markdown Here Cheatsheet e as outras páginas wiki.

^{†: E postagens de Grupos do Google, postagens do Blogger, notas do Evernote e postagens do Wordpress! Veja mais.}
^{‡: E fórmulas matemáticas TeX!}

Índice

Instruções de instalação
Instruções de uso
Solução de problemas
Compatibilidade
Notas e Diversos
Construindo os pacotes de extensão
Próximas etapas, créditos, feedback, licença

Instruções de instalação

Cromo

Loja On-line do Chrome

Vá para a página da Chrome Web Store para Markdown Here e instale normalmente.

Após a instalação, recarregue seu webmail ou reinicie o Chrome!

Manual/Desenvolvimento

Clone este repositório.
No Chrome, abra as configurações de extensões. (Botão de chave inglesa, ferramentas, extensões.)
Na página de configurações de extensões, clique na caixa de seleção "Modo de desenvolvedor".
Clique no botão agora visível "Carregar extensão descompactada…". Navegue até o diretório onde você clonou o repositório e, em seguida, o diretório src abaixo dele.
A extensão Markdown Here agora deve estar visível em sua lista de extensões.
Recarregue sua página de webmail (e talvez seu aplicativo) antes de tentar converter um email.

Firefox e Thunderbird

Site de complementos da Mozilla

Vá para a página de complementos do Firefox para Markdown aqui e instale normalmente.

Ou vá ao menu “Ferramentas > Complementos” e pesquise “Markdown Here”.

Após a instalação, certifique-se de reiniciar o Firefox/Thunderbird!

Nota: A Mozilla leva até um mês para aprovar alterações na extensão Firefox/Thunderbird, portanto, as atualizações (recursos, correções) ficarão aquém do que é mostrado aqui. Você pode optar manualmente por instalar a versão mais recente antes de revisá-la na lista de versões: https://addons.mozilla.org/en-US/firefox/addon/markdown-here/versions/

Manual/Desenvolvimento

Clone este repositório.
Siga as instruções no artigo "Sua primeira WebExtension" do MDN.

Safári

Baixe a extensão diretamente. Quando terminar o download, clique duas vezes nele para instalar.

Preferências

Para acessar as preferências do Markdown Here, abra as preferências do Safari e vá para a guia “Extensões”. Em seguida, clique na caixa "Clique em mim para mostrar as opções do Markdown aqui".

Ópera

Observe que o Markdown Here só funciona com as versões 16 e superiores do Opera (ou seja, aqueles que são baseados no Chromium).

Vá para a página da loja de complementos do Opera para Markdown aqui e instale normalmente.

Após a instalação, recarregue seu webmail ou reinicie o Chrome!

Instruções de uso

Instale-o e então…

No Chrome/Safari/Opera, recarregue sua página de webmail antes de tentar usar o Markdown Here.
No Chrome/Firefox/Safari/Opera, faça login em sua conta do Gmail, Hotmail ou Yahoo e inicie um novo e-mail. No Thunderbird, inicie uma nova mensagem.
Certifique-se de usar o editor avançado.
- No Gmail, clique no link "Formatação avançada", se estiver visível.
- No Thunderbird, certifique-se de que "Escrever mensagens em formato HTML" esteja habilitado em "Configurações da conta", painel "Composição e endereçamento".

Escreva um e-mail no Markdown. Por exemplo:

 **Olá** `mundo`.

```javascript
alert('Olá, destaque de sintaxe.');
```

Clique com o botão direito na caixa de composição e escolha o item “Markdown Toggle” no menu de contexto. Ou clique no botão que aparece na barra de endereço. Ou use a tecla de atalho ( CTRL + ALT + M por padrão).
Você deverá ver seu e-mail renderizado corretamente do Markdown em HTML rico.
Envie seu e-mail incrível para todos que você conhece. Ele aparecerá para eles da mesma forma que parece para você.

Reverter para Markdown

Depois de renderizar seu Markdown em HTML bonito, você ainda pode voltar ao Markdown original. Basta clicar com o botão direito em qualquer lugar no Markdown recém-renderizado e clicar em "Markdown Toggle" - o corpo da redação do seu e-mail mudará de volta para o Markdown que você escreveu.

Observe que quaisquer alterações feitas no belo HTML serão perdidas quando você reverter para o Markdown.

No Gmail, você também pode usar o comando Desfazer do navegador ( CTRL + Z / CMD + Z ou no menu Editar). Esteja avisado que você também pode perder os últimos caracteres inseridos.

Respostas

No Gmail, Thunderbird e Grupos do Google, você pode usar "Markdown Toggle" normalmente: basta escrever sua resposta (superior, inferior, inline, onde quer que seja) e depois converter. O e-mail original ao qual você está respondendo será deixado de lado. (Tecnicamente: os blocos blockquote existentes serão deixados intactos.)

No Hotmail e no Yahoo (que não colocam o original em blockquote ) e, opcionalmente, no Gmail, Thunderbird e Grupos do Google, você pode garantir que apenas a parte da resposta que você escreveu seja convertida selecionando o que deseja converter e clicando em "Markdown Toggle" - veja a próxima seção.

Seleção/Conversão gradativa

Às vezes você não deseja converter o e-mail inteiro; às vezes seu e-mail não é totalmente Markdown. Para converter apenas parte do e-mail, selecione o texto (com o mouse ou teclado), clique com o botão direito sobre ele e clique no item de menu "Markdown Toggle". Sua seleção é magicamente renderizada em um lindo HTML.

Para voltar ao Markdown, basta colocar o cursor em qualquer lugar do bloco de texto convertido, clicar com o botão direito e clicar novamente no item de menu "Markdown Toggle". Agora estamos magicamente de volta ao Markdown original.

O que você deve saber sobre como converter/reverter uma seleção

Se você selecionar apenas parte de um bloco de texto, somente esse texto será convertido. O bloco convertido será encapsulado em um elemento de parágrafo, portanto a linha original será quebrada. Você provavelmente não vai querer fazer isso.
Você pode selecionar e reverter vários blocos convertidos ao mesmo tempo. Uma vantagem disso é que você pode selecionar todo o seu e-mail, clicar em “Markdown Toggle” e todas as partes dele que você converteu serão revertidas.
Se você não tiver nada selecionado ao clicar em "Markdown Toggle", o Markdown Here verificará se há blocos convertidos em algum lugar da mensagem e os reverterá. Se nenhum bloco convertido for encontrado, o e-mail inteiro será convertido.

Opções

A página Opções do Markdown Here pode ser acessada por meio da lista de extensões do Chrome, Firefox, Safari ou Thunderbird. As opções disponíveis incluem:

Modificações de estilo para o Markdown renderizado.
Sintaxe destacando seleção e modificação do tema.
Habilitação e personalização do processamento de fórmulas matemáticas do TeX.
Qual deveria ser a tecla de atalho.

Para Chrome e Firefox, quaisquer alterações feitas nas opções Markdown Here são sincronizadas automaticamente entre as outras instalações desse navegador (se você tiver o recurso de sincronização ativado no navegador).

Solução de problemas

Consulte a página wiki de solução de problemas.

Compatibilidade

Consulte a página wiki de compatibilidade.

Notas e Diversos

Markdown Here usa Github Flavored Markdown, com a limitação de que links especiais do GFM não são suportados (problema nº 11); nem serão, já que o MDH não é específico do Github.
Os idiomas disponíveis para realce de sintaxe (e a maneira como devem ser escritos no bloco de código protegido) podem ser vistos na página de demonstração do highlight.js.
As imagens incorporadas em seu Markdown serão retidas quando você "Alternar Markdown". O Gmail permite que você coloque imagens embutidas em seu e-mail – isso pode ser muito mais fácil do que fazer referência a uma imagem externa.
As assinaturas de e-mail são automaticamente excluídas da conversão. Especificamente, qualquer coisa após o semi-padrão '-- ' (observe o espaço à direita) é deixado de lado.
- Observe que o Hotmail e o Yahoo não adicionam automaticamente o '-- ' às assinaturas, então você mesmo deve adicioná-lo.
O item de menu "Markdown Toggle" aparece para mais tipos de elementos do que pode ser renderizado corretamente. O objetivo é ajudar as pessoas a perceberem que não estão usando um editor avançado. Caso contrário, eles simplesmente não veem o item do menu e não sabem por quê.
Estilo:
- O uso de estilos específicos do navegador (-moz-, -webkit-) deve ser evitado. Se usados, eles podem não ser renderizados corretamente para pessoas que leem o e-mail em um navegador diferente daquele para onde o e-mail foi enviado.
- O uso de estilos dependentes de estado (como a:hover ) não funciona porque não correspondem no momento em que os estilos são explicitados. (No email, os estilos devem ser aplicados explicitamente a todos os elementos - as folhas de estilo são removidas.)
Para recursos mais aprimorados, visite a seção Dicas e truques.

Construindo os pacotes de extensão

 cd utils
node build.js

Extensão para Chrome, Opera e Firefox (WebExtension)

Crie um arquivo com extensão .zip contendo estes arquivos e diretórios:

 manifest.json
common/
chrome/
_locales

Extensão Thunderbird (XUL)

Crie um arquivo com extensão .xpi contendo estes arquivos e diretórios:

 chrome.manifest
install.rdf
common/
firefox/

Extensão Safari

O código específico do navegador está localizado no projeto markdown-here-safari .

Use o construtor de extensão Safari.

Próximas etapas

Veja a lista de problemas e o Notes Wiki. Todas as ideias, bugs, planos, reclamações e sonhos acabarão em um desses dois lugares.

Sinta-se à vontade para criar um problema de solicitação de recurso se o que você deseja ainda não estiver lá. Se você preferir uma abordagem menos formal para apresentar uma ideia, poste em nossas discussões no GitHub.

Também é preciso muito trabalho para se manter atualizado com as mudanças mais recentes em todos os aplicativos e sites onde o Markdown Here funciona.