Guia Rápido de Markdown

O Agenda não é um editor de markdown, mas reconhece parte da sintaxe markdown para aplicar estilos. Aqui estão os atalhos de markdown que podem ser usados.

Estilos de parágrafo

Os estilos a seguir mudam a aparência do parágrafo inteiro.

Título

Use de 1 a 6 símbolos de cerquilha no início da linha, seguidos de um espaço. O nível do título é dado pelo número de cerquilhas. Ex.: ### Exemplo produz um título de terceiro nível.

Lista com Traços ou Marcadores

Comece uma linha com um marcador, hífen, asterisco ou sinal de mais para criar um item de lista com traço. Ex.: • Item de exemplo 1 - Item de exemplo 2 * Item de exemplo 3 + Item de exemplo 4 produz um item de lista com traço ou marcador.

Lista Numerada

Comece uma linha com um número seguido de um ponto e um espaço para criar um item de lista numerada. Ex.: \1. Item de exemplo 1 produz um item de lista numerada.

Para iniciar uma lista numerada a partir de um número diferente de 1, basta usar esse número Ex.: \3. Item de exemplo 3 produz um item de lista numerada começando em 3.

Lista de Verificação

Comece uma linha com um hífen seguido de um colchete de abertura e um colchete de fechamento. Inserir um “x” entre os dois colchetes cria um item marcado. Ex.: - [ ] Exemplo produz um item de lista de verificação.

- [x] Exemplo produz um item marcado.

O hífen é opcional, então você também pode criar uma caixa de seleção usando apenas dois colchetes.

Pré-formatado

Para conteúdo que fica melhor em uma fonte de largura fixa, como código de computador, você pode aplicar o estilo pré-formatado. É possível acionar esse estilo iniciando a linha com três crases. Ex.: ```exemplo produz exemplo

Código

O Agenda oferece coloração de sintaxe para código de computador. Adicionando a linguagem após as três crases, você pode indicar em que linguagem o trecho de código foi escrito. Ex.: ```swift int i = 0; produz int i = 0 colorido com a linguagem Swift

Uma lista completa de todos os parâmetros de linguagem suportados é mantida pelo projeto highlight.js em https://github.com/highlightjs/highlight.js/blob/main/SUPPORTED_LANGUAGES.md.

Citação

Use um ou mais símbolos > no início da linha, seguidos de um espaço. O número de caracteres > determina o nível da citação, indicado pelas linhas verticais que precedem o texto. Ex.: > Exemplo produz

Exemplo

Estilos Alinhados

Esses estilos são usados dentro dos parágrafos para mudar a aparência do texto.

Itálico

Delimitar com sublinhados ou asteriscos aplica o estilo itálico. Ex.: _exemplo_ ou *exemplo* produz exemplo

Negrito

Delimitar com sublinhados duplos ou asteriscos duplos aplica o estilo negrito. Ex.: __exemplo__ ou **exemplo** produz exemplo

Riscado

Delimitar com tis duplos aplica o estilo riscado. Ex.: ~~exemplo~~ produz exemplo

Largura Fixa (Monoespaçado)

Para alguns conteúdos, como código-fonte de computador, é preferível ter texto de largura fixa. Para blocos de texto, o melhor é usar o estilo de parágrafo Pré-formatado. Para texto alinhado, você pode delimitar com crases. Ex.: `exemplo` produz exemplo

Destaque

Delimitar com sinais de igual duplos ou dois-pontos aplica o estilo de destaque. Ex.: ==exemplo== ou ::exemplo:: destaca a palavra exemplo

Inserir

Alguns estilos não estão relacionados ao significado do texto, mas são usados para delimitar elementos informativos, como tags. Eles também podem ser inseridos usando uma sintaxe semelhante à do markdown.

Tags

Para inserir uma tag, basta usar o símbolo #, seguido da tag. A tag não pode conter espaços. Ex.: Digite #giraffes para criar uma tag chamada “giraffes”.

Digitar um # aciona o balão de autocompletar para ajudar você a encontrar a tag que procura.

As tags também podem conter um parâmetro entre parênteses. Por exemplo, #due(12/12/2018). Para saber mais sobre como aproveitar totalmente os parâmetros nas tags, consulte o capítulo Tags, Pessoas, Ações de Texto e Links.

Tags de Pessoas

O Agenda reconhece um segundo tipo de tag, reservado a indivíduos (pessoas). Você pode inserir um nome ou iniciais para se referir a um amigo ou colega. Basta colocar um símbolo @ na frente do texto. Ex.: Digite @Tom para criar uma tag de pessoa para alguém chamado “Tom”.

Digitar um @ aciona o balão de autocompletar para ajudar você a encontrar a pessoa que procura.

Emoji

Para inserir um emoji, basta digitar : (o caractere de dois-pontos), seguido da abreviação do emoji, e novamente um : de fechamento. Ex.: Digite :+1: para inserir o emoji 👍.

Digitar um : aciona o balão de autocompletar para ajudar você a encontrar o emoji que procura.

Regra Horizontal

Se você gosta de delimitar visualmente as seções das suas notas usando uma regra horizontal (uma linha horizontal), pode fazê-lo digitando três traços seguidos e um espaço: Ex.: Digite --- para criar uma regra horizontal.

Dica: Se você estiver importando um arquivo markdown, pode dividi-lo em notas individuais no Agenda usando os mesmos três traços seguidos: Ex.: Primeira nota --- Segunda nota

Isso criará duas notas diferentes, a primeira com o conteúdo “Primeira nota” e a segunda com o conteúdo “Segunda nota”.

Tabelas

O Agenda dá a você a possibilidade de inserir tabelas nas suas notas, que podem ser criadas rapidamente digitando três ou mais símbolos de barra vertical (|) seguidos no início da linha: Ex.: Digite ||| para inserir uma tabela.

Links

Os links são reconhecidos automaticamente no texto, mas você também pode adicioná-los com a sintaxe markdown. Use colchetes para delimitar o texto exibido, seguidos de parênteses delimitando o URL do link. Ex.: Digite [Agenda](agenda.com) para criar um link para agenda.com vinculado ao texto “Agenda”.

Ações de Texto

Embora não façam parte estritamente da sintaxe markdown clássica, o Agenda permite acionar certas ações se você começar digitando o símbolo de barra invertida , seguido de uma ação.

Por exemplo, \remind aciona a inserção de um lembrete na sua nota. Parâmetros opcionais podem ser fornecidos como parte da ação; por exemplo, \remind(today at noon) agenda um lembrete para hoje ao meio-dia. Outras ações comuns são \now, \date e \time, para inserir a data e a hora atuais.

Para uma visão geral completa de todas as ações, consulte o capítulo Guia Rápido de Ações de Texto.

As ações também podem ser usadas como marcadores de posição em modelos; consulte o capítulo Criando e Usando Modelos.

Impedindo a interpretação do markdown

Embora os atalhos de markdown possam ser superúteis e rápidos, há momentos em que você pode não querer que algo seja reconhecido como markdown. Você pode escapar as sequências de markdown acima digitando primeiro um caractere de barra invertida \, seguido do que você normalmente digitaria. Ao pressionar espaço, o caractere de barra invertida deve desaparecer automaticamente e o texto deve permanecer como você digitou. Por exemplo, digitar \1. Something não resultará em uma lista numerada, mas no texto 1. Something.

Observe que o markdown nunca é interpretado dentro de texto que tenha o estilo de parágrafo Preformatted e o estilo alinhado Fixed Width.