Um editor WYSIWYG para editar ficheiros Markdown?
Interrested ? Siga o guia!
Actualização: Typora não é um software de código aberto, e apenas a versão beta parece ser livre. Se a adopção de hábitos num software gratuito para software pago mais tarde o aborrece, sugerimos a utilização de um clone typora de código aberto: MarkText.
MarkText, From Markdown, with Love
Esta ferramenta chama-se typora, e o site oficial está lá: typora MarkText
Apresento-vos esta ferramenta que irei testar para a série de artigos em torno do gitlab CI / CD.
Está disponível para Windows, Linux, e Mac OS.
Obtenha o poder de Markdown, sem utilizar Markdown
As características do editor fornecem-lhe o poder do formato markdown, porque é possível guardar ficheiros directamente em markdown, mas também copiar o texto em formato markdown.
What You See Is What You Get
Aqui está o artigo, na sua versão em francês, aberto com typora. (MarkText teria exactamente o mesmo resultado)
Pode aplicar o estilo que desejar (Header 1-2-3, bold, etc. ) seleccionando-o no menu, ou utilizando os atalhos padrão (CTRL+B, CTRL+I)
Guardar em Markdown
Só tem de guardar o ficheiro com marktext (apenas .md está autorizado) ou escolher markdown com typora (que propõe também .txt)
Conteúdo da remarcação para exportação
Typora MarkText permite-lhe exportar (ou copiar) uma parte do documento, directamente com a sintaxe de markdown.
Aqui está o resultado da exportação com a versão em francês do artigo:
Un éditeur WYSIWYG pour éditer des fichiers Markdown ?
Si ça vous intrigue, suivez le guide !
# Typora, par amour du markdown
C'est outil s'appelle typora, et le site officiel est là: [typora](https://typora.io/)
Je vous présente cet outil que je vais tester pour la série d'article autour de gitlab CI/CD.
Il est disponible pour Windows, Linux, et en version beta (à l'heure d'acriture de ces lignes) pour Mac OS.
## Des fonctionnalités pour profiter de la puissance du markdown
Les fonctionnalités de l'éditeur permettent de profiter de la puissance du format markdown, car il est à la fois possible de sauvegarder des fichiers directement en markdown, mais également de copier le texte au format markdown.
### Un éditeur wysiwyg
Voici, par exemple, le rendu de cet article (dans sa version française)
Só tem de seleccionar a peça que pretende exportar, e utilizar a entrada do menu, ou utilizar o atalho: CTRL + MAJ + C (o atalho funciona tanto em typora como em marktext)
Corrector ortográfico
Presumo que saibam do que estou a falar.
Qualidade Markdown
Utilizamos, para garantir a qualidade da sintaxe dos nossos ficheiros markdown, uma ferramenta chamada markdownlint. A versão em francês do post obteve esse resultado:
$ mdl content/posts/*.md --ignore-front-matter --rules ~MD013,~MD026,~MD033
content/posts/typora_fr.fr.md:13: MD009 Trailing spaces
content/posts/typora_fr.fr.md:15: MD009 Trailing spaces
content/posts/typora_fr.fr.md:21: MD009 Trailing spaces
content/posts/typora_fr.fr.md:23: MD009 Trailing spaces
content/posts/typora_fr.fr.md:27: MD009 Trailing spaces
content/posts/typora_fr.fr.md:39: MD009 Trailing spaces
content/posts/typora_fr.fr.md:45: MD009 Trailing spaces
content/posts/typora_fr.fr.md:47: MD009 Trailing spaces
content/posts/typora_fr.fr.md:50: MD009 Trailing spaces
content/posts/typora_fr.fr.md:52: MD009 Trailing spaces
content/posts/typora_fr.fr.md:58: MD009 Trailing spaces
content/posts/typora_fr.fr.md:60: MD009 Trailing spaces
content/posts/typora_fr.fr.md:64: MD009 Trailing spaces
content/posts/typora_fr.fr.md:75: MD009 Trailing spaces
content/posts/typora_fr.fr.md:81: MD009 Trailing spaces
content/posts/typora_fr.fr.md:82: MD009 Trailing spaces
content/posts/typora_fr.fr.md:84: MD009 Trailing spaces
content/posts/typora_fr.fr.md:96: MD009 Trailing spaces
content/posts/typora_fr.fr.md:100: MD009 Trailing spaces
content/posts/typora_fr.fr.md:109: MD009 Trailing spaces
content/posts/typora_fr.fr.md:35: MD012 Multiple consecutive blank lines
content/posts/typora_fr.fr.md:36: MD012 Multiple consecutive blank lines
content/posts/typora_fr.fr.md:90: MD012 Multiple consecutive blank lines
content/posts/typora_fr.fr.md:91: MD012 Multiple consecutive blank lines
content/posts/typora_fr.fr.md:105: MD012 Multiple consecutive blank lines
content/posts/typora_fr.fr.md:106: MD012 Multiple consecutive blank lines
A sintaxe de markdown parece ser boa. A única coisa que não é fixada pela ferramenta são as regras que dizem respeito a espaços duplos, espaços no fim das linhas, linhas em branco duplas, etc.
Numa palavra: tudo o que se pode VER no wySiwyg.
O propósito da utilização do Marktext/Typora
Postagens de websites de Hugo
O MarkText é muito útil para escrever o conteúdo de texto do sítio de Hugo, gosta de posts ou descrições de autores.
Por exemplo, pode simplesmente copiar o conteúdo MD no editor web gitlab/github, colá-lo no Marktext, modificá-lo, e copiar como MD para o colar novamente no editor gitlab/github.
Também pode gerir o foder de conteúdo directamente na ferramenta, mas terá de usar o gitlab/github em bash para empurrar a sua modificação no repositório gitlab/github:
As nossas ferramentas
Estamos a utilizar um conjunto de ferramentas baseadas em (ou conformes com) markdown:
- Wikis;
- READMEs de código de base;
- Base de Conhecimento;
- Relatórios de Decisão de Arquitectura
A ferramenta de exportação (também conhecida como copy as markdown) é muito útil para poder editar texto como num editor de texto padrão, mas poder usar o poder de markdown quando se pretende alterar a estrutura de um texto. Este caso aparece normalmente quando se edita um wiki ou uma página kb. Quanto mais acrescentarmos, mais precisamos de rever a estrutura.
Conclusão
Vou começar os artigos sobre o gitlab CI/CD com Marktext, e, para ser honesto, penso realmente que vou voltar a um editor MD.
Mas tenho de confessar que é uma grande ferramenta para aqueles que querem obter o poder do Marktext sem aprender/exercitar a sintaxe. E não tenho a certeza absoluta de que voltarei a um editor padrão depois de adquirir hábitos no Marktext...