Ajuda
O que é o Markzen?
O Markzen é um editor de ambiente de trabalho para linguagens de marcação leves — Markdown e seis outras — com uma pré-visualização em tempo real e totalmente estilizada. Escreve texto simples marcado com pontuação simples à esquerda, e o Markzen renderiza-o como HTML formatado à direita enquanto escreve.
O que o distingue de um editor Markdown comum é o ciclo completo. O Markzen lê oito linguagens de marcação, renderiza 30 extensões em tempo real (diagramas, gráficos, fórmulas matemáticas, partituras, tabuleiros de xadrez, códigos QR) dentro do documento e exporta para mais de vinte formatos — ebooks, Word, PowerPoint, LaTeX, blocos de notas Jupyter e muito mais. Escreva uma vez, entregue o resultado como quase tudo. O conversor está incorporado, por isso não há ferramentas externas para instalar.
Pode abrir um ficheiro existente ou simplesmente começar a escrever — não é necessário abrir um ficheiro primeiro.
O editor
O painel esquerdo é um editor de código CodeMirror completo, não uma caixa de texto simples: tem realce de sintaxe para a marcação que está a escrever, uma barra de ferramentas de formatação (negrito, itálico, títulos, listas e muito mais, além de botões dedicados para inserir ligações e imagens — consulte Ligações e imagens — e para inserir uma tabela, consulte Tabelas e folhas de cálculo), e uma pesquisa de localizar e substituir. Os atalhos de edição padrão — copiar, colar, anular, refazer — funcionam como esperado.
Escreve numa das oito linguagens de marcação leves. Estes são formatos de texto simples que expressam estrutura com pontuação (# para um título, * para ênfase) em vez de estilo oculto, para que um documento permaneça legível como texto e amigável para diferenças no controlo de versão. Markzen lê todas as oito e decide qual é o ficheiro pela sua extensão — nunca escolhe o formato manualmente. Compatibilidade lista quais extensões abrem qual linguagem.
Cada linguagem tem as suas próprias convenções e o seu próprio ecossistema de documentos existente; Markzen renderiza cada uma no seu próprio dialeto em vez de converter tudo para Markdown primeiro. BBCode é a única sem um único padrão — cada fórum inventou a sua própria variante — então Markzen lê-a generosamente, aceitando as grafias comuns lado a lado ([list] ou [ul], [h1] ou [heading=1]) e deixando qualquer etiqueta que não reconheça visível como texto simples em vez de a engolir. Para mudar o tipo de marcação em que um documento está escrito, use o menu Converter para da barra de ferramentas (consulte Converter e exportar abaixo).
Nem todas as linguagens podem expressar tudo. A barra de ferramentas de formatação tem os mesmos botões em todos os documentos, mas Markzen apenas escreve a marcação que a própria linguagem define — nunca inventa um dialeto privado para encobrir uma lacuna. Um botão para o qual a linguagem atual não tem notação fica cinzento. Negrito, itálico, títulos, listas, blocos de código, ligações, imagens, regras e tabelas estão disponíveis em todas as oito; o punhado de lacunas está listado em Compatibilidade. O Markdown é o que surpreende as pessoas: não tem uma forma padrão de centrar um parágrafo, então Markzen não oferece botões de alinhamento lá em vez de escrever algo que apenas alguns leitores honrariam.
O tamanho do texto é definido com os botões Aumentar tipo de letra e Reduzir tipo de letra da barra de ferramentas. O painel do editor também pode ser totalmente ocultado — quando o é, Markzen torna-se um leitor puro (consulte Pré-visualização ao vivo).
Ligações e imagens
A barra de ferramentas de formatação tem dois botões dedicados para inserir uma ligação ou uma imagem no documento, e cada um abre um pequeno pop-up exatamente onde o cursor está. Ligação (Ctrl+K) — ou prima Ctrl+K — insere uma hiperligação: digite o texto da ligação e o seu endereço, e o Markzen escreve a marcação correta para ela. Imagem insere uma imagem da mesma forma, com algumas opções adicionais abordadas abaixo.
Ambos são escritos na marcação que o documento atual usa — uma ligação inserida num ficheiro AsciiDoc aparece como AsciiDoc, num ficheiro Org como Org, e assim por diante em todas as oito linguagens.
Começando com um endereço que já tem. Cole um endereço web no documento, selecione-o e prima Ctrl+K: o Markzen vê que a seleção é um endereço em vez de palavras, coloca-o no campo de endereço do pop-up e deixa o cursor no campo de texto vazio, à espera do que a ligação deve dizer. Sem isso, um endereço selecionado teria-se tornado o texto visível da ligação — uma ligação que se lê como um URL simples. Caminhos de ficheiro absolutos também contam como endereços, no Windows e noutros locais, então o mesmo atalho transforma um caminho colado numa ligação para esse ficheiro.
Editar uma ligação ou imagem que já tem. Coloque o cursor em qualquer parte de uma ligação ou imagem existente e abra o pop-up novamente (o botão, ou Ctrl+K): o Markzen reconhece a construção, carrega o seu texto e endereço atuais no pop-up e substitui tudo quando confirma — assim, edita-o no local em vez de aninhar acidentalmente uma nova ligação dentro da antiga.
Para uma imagem, o pop-up também oferece um botão Procurar uma imagem para escolher um ficheiro do disco em vez de digitar um caminho — abre na pasta de onde tirou a última imagem, mantida separadamente daquela de onde vêm os seus documentos — e uma escolha importante: se a imagem está incorporada ou ligada.
Imagens incorporadas ou ligadas
Quando insere uma imagem, o Markzen pode armazená-la no documento de duas formas:
- Ligado — o documento apenas aponta para a imagem, por caminho de ficheiro ou endereço web. O ficheiro do documento permanece pequeno, mas a imagem tem de viajar com ele (ou permanecer acessível no seu URL), ou não aparecerá noutros locais. Esta é a predefinição.
- Incorporado — os bytes reais da imagem são escritos no documento como texto (um bloco
data:base64), então o ficheiro é completamente autónomo: um ficheiro transporta tudo, sem nada a perder de vista. A desvantagem é o tamanho — o documento cresce com o peso da imagem, e uma imagem incorporada não pode usar um caminho relativo.
Escolha Incorporada quando quiser um único ficheiro portátil para entregar; escolha Ligada quando mantiver as imagens ao lado do documento e quiser que o ficheiro permaneça pequeno.
Para uma imagem ligada, aparece mais uma opção: Caminho relativo. Quando a imagem está na própria pasta do documento (ou numa subpasta), marcar esta opção escreve a referência como um caminho relativo curto em vez de um absoluto completo, para que a ligação continue a funcionar quando move o documento e as suas imagens juntos. É oferecida apenas quando a imagem está dentro da pasta do documento — caso contrário, não há caminho relativo para escrever.
As imagens incorporadas permanecem organizadas no editor. Uma imagem incorporada em base64 é uma longa parede de texto que, de outra forma, enterraria as linhas à sua volta, então o Markzen dobra cada uma num pequeno chip mostrando o seu tipo e tamanho (por exemplo, 🖼 webp · 38 KB). O chip é apenas para exibição — o texto subjacente permanece intocado, então guardar, copiar ou cortar sempre transporta a imagem completa, e o cursor salta sobre o chip como uma única unidade.
Ficheiros, separadores e gravação
O Markzen mantém tantos documentos abertos de uma só vez quanto desejar, cada um no seu próprio separador, para que possa trabalhar em vários ficheiros e alternar entre eles livremente. Não precisa de abrir um ficheiro para começar — comece a escrever no documento em branco que já está lá, ou use os botões de ficheiro da barra de ferramentas:
- Novo documento — abre um pequeno menu (Criar um novo) listando as oito linguagens de marcação; escolha uma para iniciar um documento novo e vazio escrito nessa marcação, num novo separador.
- Abrir um ficheiro Markdown — procure um ficheiro existente e abra-o. O seletor aceita todos os oito formatos de marcação, e o Markzen escolhe o correto a partir da extensão do ficheiro. Abre na pasta de onde tirou um documento pela última vez, lembrada entre sessões, para que não comece do zero cada vez.
- Guardar — grava o documento ativo de volta para o seu ficheiro. Um documento que nunca foi gravado passa para Gravar Como para que possa nomeá-lo primeiro.
- Guardar como — grava o documento ativo num novo ficheiro, deixando qualquer original intocado.
Também pode arrastar um ficheiro do seu gestor de ficheiros e largá-lo na janela para o abrir.
Cada documento aberto é um separador na parte superior da janela. Um separador não gravado é marcado com um ponto, e um separador cuja marcação não é Markdown tem um pequeno distintivo de formato (por exemplo adoc). O × num separador fecha-o — e fechar um documento com alterações não gravadas nunca as descarta silenciosamente: uma barra inline aparece no separador para que possa Guardar ou Descartar primeiro.
Enquanto um documento está aberto, o Markzen monitoriza o seu ficheiro no disco. Se o ficheiro mudar noutro programa e não tiver edições não gravadas suas, o Markzen puxa a nova versão automaticamente; se tiver edições não gravadas, pergunta primeiro — uma barra inline Recarregar permite-lhe decidir se quer aceitar a versão no disco ou manter a sua.
Pré-visualização ao vivo
O painel direito é o documento renderizado como HTML estilizado, atualizado ao vivo enquanto digita. Os links funcionam, as tabelas alinham-se, o código é mostrado num bloco monoespaçado, as listas de tarefas recebem caixas de seleção e cada bloco de extensão de renderização (ver abaixo) desenha a sua figura no local. A pré-visualização é uma imagem fiel do que uma exportação HTML ou PDF irá parecer.
Se um documento Markdown abrir com um bloco YAML front-matter — a secção --- key: value --- que ferramentas como Jekyll, Hugo e Obsidian colocam no topo — o Markzen renderiza-o como um cartão de metadados organizado acima do documento, em vez de deixar o --- de fecho transformar-se num cabeçalho perdido.
Modos de layout
Um grupo de três botões da barra de ferramentas define o que a janela mostra:
- Vista dividida — editor e pré-visualização lado a lado. Arraste o divisor para alterar o espaço que cada um ocupa.
- Mostrar editor — o editor sozinho, preenchendo a janela para uma escrita sem distrações.
- Mostrar pré-visualização — a pré-visualização sozinha, um leitor limpo de largura total.
Tabela de conteúdos
O botão Índice abre um painel construído automaticamente a partir de cada cabeçalho no documento (#, ##, ###, …). Clique em qualquer entrada para rolar a pré-visualização para essa secção. Qualquer cabeçalho com sub-cabeçalhos abaixo dele mostra um chevron: clique nele para Recolher essa secção e ocultar os seus cabeçalhos aninhados, ou Expandir para os trazer de volta — para que possa dobrar um esquema longo apenas para as partes em que está a trabalhar. Os pequenos botões 2 / 3 / 4 no cabeçalho do painel limitam o esquema a essa profundidade de cabeçalho — útil num documento longo quando só quer os níveis superiores visíveis — e clicar novamente no ativo traz todos os níveis de volta. O painel redimensiona-se arrastando a sua borda esquerda e recolhe-se para libertar espaço de leitura. É uma ajuda de navegação apenas dentro da aplicação — nunca aparece numa exportação.
Fornecer o seu próprio esquema. Se os cabeçalhos não forem o esquema que deseja, um documento pode ter o seu próprio. Um bloco de código marcado markzen cuja primeira linha é toc substitui o painel gerado pela lista escrita abaixo dele:
`markdown
```markzen
toc
- [Introduction](#intro)
- [Background](#background)
- [Results](#results)
```
A indentação define o nível, e cada entrada aponta para uma âncora que tem de existir no próprio documento — um cabeçalho ao qual deu um id explícito, ou um simples <a id="intro"></a>. O bloco em si não desenha nada: é metadados que o painel lê.
Tabelas e folhas de cálculo
As tabelas movem-se facilmente entre o Markzen e qualquer folha de cálculo. Cole texto separado por tabulações — copiado do Excel, Google Sheets, Word ou de uma tabela web — no editor e o Markzen transforma-o numa tabela adequada escrita na própria marcação do documento, em vez de inserir uma parede de caracteres de tabulação. O leitor de colagem tem consciência de aspas (lida corretamente com células que contêm tabulações, quebras de linha ou aspas) e só é acionado quando a área de transferência contém uma grelha retangular limpa de pelo menos duas colunas; qualquer outra coisa é colada como texto comum.
Também pode começar uma tabela do zero. O botão Inserir tabela da barra de ferramentas abre uma pequena grelha — deslize sobre ela para escolher quantas linhas e colunas deseja, e o Markzen escreve uma tabela vazia desse tamanho na própria marcação do documento, pronta para ser preenchida. A primeira linha é a linha do cabeçalho.
O inverso também funciona. Passe o rato sobre qualquer tabela renderizada na pré-visualização e um botão de cópia aparece no seu canto: ele copia a tabela de volta como texto separado por tabulações que pode ser inserido diretamente numa célula de folha de cálculo ou num documento do Word. Estes botões de cópia são apenas uma conveniência de pré-visualização — são removidos de todas as exportações e conversões, para que um ficheiro partilhado contenha apenas a tabela limpa.
Extensões de renderização
Markzen estende a marcação padrão através de blocos de código. A tag de linguagem logo após os três backticks de abertura decide como o bloco é renderizado: uma tag que Markzen reconhece como uma extensão desenha uma figura ao vivo em vez de mostrar o código.
Cada tipo de figura é desenhado pelo seu próprio motor de renderização, e Markzen busca um motor na primeira vez que um documento realmente o solicita, em vez de carregar todos eles no lançamento — é por isso que a aplicação inicia quase instantaneamente, e por que o primeiro diagrama de um determinado tipo pode demorar um momento a aparecer, enquanto todos os posteriores são imediatos.
Por exemplo, esta fonte:
```mermaid
graph LR
A --> B --> C
```
renderiza como um fluxograma ao vivo, não como uma listagem de código — e permanece um fluxograma também nas exportações para PDF e HTML.
Diagramas, gráficos, matemática, notação musical, tabuleiros de xadrez e Go, códigos QR e muito mais estão incorporados — Compatibilidade lista cada um deles com a sua tag.
Cada extensão tem a sua própria tag de linguagem (mermaid, chartjs, katex, abc, chess, …). Pode misturar quantas quiser com prosa comum num único documento — todos renderizam juntos. Se uma figura ainda é uma figura depois que o documento sai de Markzen depende de para onde a envia — veja Converter e exportar abaixo.
Fórmulas dentro de uma frase
Uma fórmula matemática pode ser um bloco próprio — um bloco katex ou asciimath, sozinho e centrado como uma equação num livro didático. Isso funciona em todas as oito linguagens de marcação.
Uma fórmula também pode estar dentro de uma frase, de modo que "a área é pi r quadrado" seja lida como uma linha de prosa com símbolos reais. Isso depende da linguagem de marcação ter uma notação para isso, e cada uma a escreve de forma diferente — a notação por linguagem está em Compatibilidade.
Textile e BBCode são as duas exceções, e é um limite dessas linguagens em vez de Markzen: nenhuma delas jamais definiu uma maneira de escrever matemática. Num documento Textile ou BBCode, uma fórmula, portanto, tem que ser um bloco próprio. Nada se perde — a fórmula renderiza e sobrevive à exportação — simplesmente não pode ser entrelaçada numa linha de prosa.
Posicionar e dimensionar uma figura
Passe o rato sobre uma figura renderizada na pré-visualização e um pequeno painel aparece ao lado dela: botões alinhamento (esquerda, centro, direita) e — para os tipos de figura que podem ser redimensionados — caixas largura e altura em pixels. remover bloco de estilo limpa-os novamente.
Essa escolha não é mantida em algum lugar invisível: o painel escreve-a no documento, como um pequeno bloco com a tag markzen colocado imediatamente antes da figura a que se aplica.
```markzen
style
align center
width 480
```
Assim, o layout viaja com o ficheiro — faz parte do que guarda, entrega e exporta, em qualquer máquina. Pode igualmente escrever o bloco à mão: uma diretiva por linha, align (left, center ou right), width e height em pixels, sempre aplicando-se ao bloco diretamente abaixo dele.
Estilizar um documento com CSS
Um documento Markdown também pode ter a sua própria folha de estilo, num bloco de código com a tag style:
```style
h2 { color: #b03030; border-bottom: 2px solid #b03030; }
blockquote { font-style: italic; }
```
As regras aplicam-se à pré-visualização desse documento e às suas exportações para PDF e HTML, além de qualquer modelo de estilo ativo — uma forma de dar a um documento um visual próprio sem alterar as suas configurações para todo o resto. Apenas seletores comuns: regras at-rules como @media e @keyframes não são suportadas, e o bloco funciona apenas em documentos Markdown.
Converter e exportar
O menu Converter para da barra de ferramentas é onde um documento finalizado sai do Markzen. Ele faz duas coisas distintas.
Converter para outra linguagem de marcação. Em Marcação leve, reescreva o documento aberto como qualquer uma das outras sete marcações — AsciiDoc, BBCode, Djot, MediaWiki, Org, reStructuredText ou Textile. Útil quando um wiki quer MediaWiki, um fórum quer BBCode, um editor quer AsciiDoc, ou você está movendo notas entre ecossistemas. Cada uma das oito aparece uma vez no menu, como uma linguagem de marcação: um documento salvo como MediaWiki a partir daqui é o mesmo arquivo que você obteria em qualquer outro lugar.
Exportar para um formato finalizado. Entregue o documento ao conversor incluído, que emite mais de vinte formatos de documento, agrupados pelo seu propósito:
| Categoria | Formatos |
|---|---|
| E-books | EPUB 3, FictionBook2 |
| Processador de texto | Microsoft Word (.docx), OpenDocument (.odt), Rich Text Format (.rtf) |
| Apresentação | Microsoft PowerPoint (.pptx), reveal.js (.html) |
| Composição | InDesign ICML, LaTeX (.tex), Typst (.typ) |
| XML | DocBook, JATS, OpenDocument XML, TEI Simple |
| Caderno | Jupyter Notebook (.ipynb) |
| Esboço | OPML (.opml) |
O conversor é fornecido dentro do Markzen — nada extra para baixar ou configurar. Além disso, três saídas rápidas estão na barra de ferramentas: Guardar como PDF e Guardar como HTML exportam o documento renderizado exatamente como pré-visualizado (modelo de estilo, fontes e figuras de extensão incluídas), e Imprimir o envia para uma impressora. A fonte do código viaja dentro do arquivo exportado, então um bloco de código ou um diagrama ASCII aparece na máquina do leitor da mesma forma que você o viu, independentemente de terem ou não essa fonte instalada.
O que viaja e o que não viaja. Uma figura de extensão de renderização só permanece uma figura onde o formato de destino pode conter uma imagem, então um documento sai do Markzen por uma de duas rotas:
- Como o documento que você vê — as três saídas da barra de ferramentas acabadas de descrever (PDF, HTML, impressão) e cinco dos formatos na tabela acima: EPUB 3, Microsoft Word (
.docx), OpenDocument (.odt), Microsoft PowerPoint (.pptx) e Rich Text Format (.rtf). Diagramas, fórmulas e partituras são escritos como imagens e chegam intactos. - Como o texto fonte do documento — todos os outros destinos e todas as conversões para outra linguagem de marcação. Prosa, títulos, listas, tabelas e links são todos convertidos; um bloco
mermaidoukatexchega como um bloco de código comum contendo a fonte que você digitou, porque esses formatos não têm uma figura para o Markzen entregar.
Assim, um documento construído em torno de diagramas é melhor entregue como PDF, HTML, EPUB, Word, OpenDocument, PowerPoint ou RTF. LaTeX, Typst, reveal.js e o resto ainda fornecem o documento completo — com a fonte de cada figura deixada no lugar, pronta para as ferramentas desse ecossistema.
Exportar a partir da linha de comandos
Markzen também funciona sem abrir uma janela. Passe o executável do Markzen um ficheiro de origem e -o com um caminho de saída, e ele renderiza o documento e escreve a exportação diretamente para o disco:
markzen.exe report.md -o report.pdf
A origem pode ser qualquer um dos oito formatos de marcação que o Markzen lê; a saída é um ficheiro PDF ou HTML, escolhido pela extensão do nome de saída. A exportação passa pela mesma renderização que a própria aplicação, pelo que diagramas, fórmulas e todos os outros blocos de extensão aparecem como figuras ativas. As exportações utilizam o modelo de estilo e as fontes predefinidas — a linha de comandos é executada no seu próprio perfil limpo, separado da aplicação, o que também significa que funciona bem enquanto o Markzen já está aberto.
Vários documentos podem ser exportados numa única chamada — forneça qualquer número de pares source -o output e um único lançamento renderiza-os todos, a uma fração do custo de lançamento uma vez por ficheiro:
markzen.exe a.md -o a.pdf b.adoc -o b.html c.rst -o c.pdf
Tipos de letra e aparência
O Markzen foi concebido para que um documento tenha um aspeto tipográfico em vez de genérico. Os controlos para isso estão juntos na barra de ferramentas atrás do botão Estilo e tipos de letra, para que os possa ajustar enquanto lê; o tema e o idioma da interface estão em Definições → Apresentação.
Modelo de estilo
Estilo oferece cinco estilos de pré-visualização: Standard, GitHub, Book, Modern, Minimal. O modelo que escolher é também o estilo aplicado às exportações PDF e HTML, por isso decide como um documento partilhado é lido — escolha Book ou Modern para algo que vai entregar, Minimal para uma leitura sem distrações. O modelo estiliza apenas a pré-visualização, nunca o editor.
Tipos de letra
Três seletores no mesmo painel definem um tipo de letra separado para cada tipo de texto — Título, Corpo e Código — o que faz com que um documento Markzen pareça tipográfico:
- Título — Oswald, Playfair Display, Merriweather, Raleway, Montserrat, Lora, Libre Baskerville, Bebas Neue, Abril Fatface, Cinzel.
- Corpo — Inter, Roboto, Georgia, Lato, Source Serif 4, Nunito, PT Serif, Crimson Text, Libre Franklin, Open Sans.
- Código — JetBrains Mono, Source Code Pro, Cascadia Mono, Fira Mono.
Os tipos de letra de código são escolhidos por uma propriedade para além do aspeto: todos desenham os caracteres de desenho de caixas (│ ├ └ ─) de que são feitos os listagens de árvores e os diagramas ASCII, para que uma árvore de diretórios colada num bloco de código mantenha a sua forma em vez de se partir em espaços. São também as variantes sem ligaduras — um tipo de letra com ligaduras redesenha != como um único ≠, o que é agradável num editor de código e errado num documento que se destina a mostrar o que o ficheiro realmente diz. JetBrains Mono e Source Code Pro são fornecidos com o Markzen, por isso funcionam numa máquina que nunca os viu e sem qualquer ligação.
Tamanho do texto
Os botões Aumentar tipo de letra e Reduzir tipo de letra da barra de ferramentas alteram o tamanho do texto.
Tema e idioma
Em Definições → Apresentação:
- Tema — Claro ou Escuro. Predefinição: Claro.
- Idioma — A própria interface do Markzen está traduzida para mais de cinquenta idiomas, incluindo scripts da direita para a esquerda (árabe, hebraico) e CJK (chinês, japonês, coreano).
Compatibilidade
As tabelas de referência: o que cada linguagem de marcação suporta e cada tipo de figura dinâmica que o Markzen pode desenhar. Tudo aqui é sobre o que funciona onde — as explicações estão nas seções acima.
O que cada linguagem de marcação pode fazer
| Linguagem de marcação | Abre ficheiros terminados em | Figuras dinâmicas | Painel de conteúdos | Fórmula numa frase | Não consegue expressar |
|---|---|---|---|---|---|
| Markdown | .md, .markdown |
todas | sim | $…$ |
alinhamento de texto |
| AsciiDoc | .adoc, .asciidoc, .asc |
todas, exceto style |
sim | apenas bloco | rasurado |
| reStructuredText | .rst, .rest |
todas, exceto style |
sim | $…$ |
rasurado |
| Org | .org |
todas, exceto style |
sim | $…$ |
alinhamento à esquerda e à direita |
| Textile | .textile |
todas, exceto style |
sim | apenas bloco | — |
| Djot | .dj |
todas, exceto style |
sim | $`…` |
— |
| MediaWiki | .wiki, .mediawiki, .wikitext |
todas, exceto style |
sim | <math> |
código inline, rasurado, citação em bloco, alinhamento de texto |
| BBCode | .bbcode, .bb |
todas, exceto style |
sim | apenas bloco | — |
Figuras dinâmicas — o bloco style é a única exceção: aplica CSS ao próprio documento, o que apenas o Markdown suporta. Todos os outros tipos de figuras funcionam em todas as linguagens. Num documento BBCode, o bloco é escrito [code=mermaid]…[/code] em vez de com acentos graves; no MediaWiki, <syntaxhighlight lang="mermaid">…</syntaxhighlight>.
Não consegue expressar — estes são limites das próprias linguagens de marcação, não do Markzen: onde uma linguagem não tem notação para algo, o Markzen não oferece um botão para isso, em vez de escrever um dialeto privado que só ele conseguiria ler. Consulte Fórmulas dentro de uma frase para a linha de matemática.
Todos os tipos de figuras
Escreva a etiqueta após os três acentos graves de abertura — ```mermaid — e o bloco torna-se uma figura.
| Categoria | Figura | Etiqueta de bloco | Notas |
|---|---|---|---|
| Diagramas | Mermaid | mermaid |
fluxogramas, sequência, classe, Gantt, ER, estado |
| Graphviz | graphviz |
a linguagem DOT | |
| Cytoscape | cytoscape |
gráficos de rede; panorâmica e zoom na pré-visualização | |
| Markmap | markmap |
mapa mental a partir de um esquema com marcadores; clique para dobrar | |
| Timeline | timeline |
linha do tempo de eventos vertical | |
| Diagramas de software | Nomnoml | nomnoml |
UML |
| PlantUML | plantuml |
UML — a única figura que precisa de uma ligação à internet | |
| DBML | dbml |
diagramas de esquema de base de dados | |
| Gráficos | Chart.js | chartjs |
barras, linhas, setores, radar |
| Vega-Lite | vega-lite |
gráficos declarativos de JSON | |
| ECharts | echarts |
gráficos interativos grandes | |
| Desenvolvimento de TI | Pseudocode | pseudocode |
algoritmos tipográficos |
| Tabulator | tabulator |
tabela interativa classificável | |
| Bytefield | bytefield |
layouts de campos de bits e bytes | |
| QR Code | qrcode |
||
| Railroad | railroad |
diagramas de sintaxe | |
| WaveDrom | wavedrom |
diagramas de temporização digital | |
| Matemática | KaTeX | katex |
também $…$ numa frase — consulte a tabela acima |
| AsciiMath | asciimath |
notação matemática em texto simples | |
| Gráficos | function-plot | fnplot |
traçar uma curva de função |
| JSXGraph | jsxgraph |
geometria interativa | |
| Plotly | plotly |
gráficos científicos e 3D | |
| Ciências | SMILES | smiles |
diagramas de estrutura química |
| Música | ABC Notation | abc |
partituras de texto simples |
| VexFlow | vexflow |
pautas gravadas | |
| VexChords | vexchords |
diagramas de acordes de guitarra | |
| ChordPro | chordpro |
acordes acima das letras | |
| MusicXML | musicxml |
partituras completas | |
| Jogos | Chess | chess |
um tabuleiro a partir de uma posição FEN |
| Go Board | goboard |
9×9, 13×13 e 19×19 | |
| Documento | Markzen | markzen |
invisível: posiciona e dimensiona a figura abaixo dela, ou substitui o painel de conteúdos |
| Style | style |
invisível: CSS para este documento — apenas Markdown |
Associações de ficheiros
No Windows, o instalador pode registar o Markzen como um manipulador para todos os tipos de ficheiros de marcação que lê — todas as quinze extensões listadas em Compatibilidade, em todas as oito linguagens. Uma vez registado, fazer duplo clique num desses ficheiros no Explorador abre-o diretamente no Markzen, e se vários editores estiverem instalados, ainda pode escolher o Markzen através de "Abrir com…".
Atalhos de teclado
| Tecla | Ação |
|---|---|
Ctrl+S |
Guardar |
Ctrl+Shift+S |
Guardar como |
Ctrl+ + / Ctrl+ - |
Aumentar / diminuir o tamanho do texto |
Os atalhos padrão do editor — localizar, substituir, copiar, colar, anular, refazer — e os atalhos da barra de ferramentas de formatação (negrito Ctrl+B, itálico Ctrl+I, cabeçalho Ctrl+H, ligação Ctrl+K e mais) funcionam no painel do editor. Um atalho de formatação existe apenas onde a marcação atual tem a construção — Ctrl+D não faz nada num documento AsciiDoc, que não tem o seu próprio rasurado (ver O editor).
Dicas
- Oculte o editor para ler. A vista única com a pré-visualização visível transforma o Markzen num leitor limpo, e os cinco modelos de estilo permitem-lhe definir a sua aparência.
- Um documento, todo o tipo de conteúdo. Um fluxograma Mermaid, uma equação KaTeX e uma partitura musical podem coexistir com prosa simples — todos são renderizados em conjunto e todos sobrevivem à exportação para PDF e HTML.
- O modelo de estilo é a aparência da exportação. Qualquer modelo que escolha é o estilo incorporado na saída PDF e HTML, por isso defina-o antes de exportar.
- Escreva na marcação que gosta, entregue no formato que precisam. Rascunhe em Markdown (ou qualquer um dos oito), depois use Converter para um ficheiro Word, uma apresentação de slides, um ebook ou uma fonte LaTeX — sem necessidade de ferramentas separadas.