Texto no formato Markdown Markdown é uma extensão do formato de texto simples usado no Bimboo que permite adicionar ênfase (negrito, itálico), estruturas (marcas de pontos e cabeçalhos) e apontadores (para imagens ou outros recursos Web). Pode-se usar Markdown em qualquer lugar no Bimboo, escolha simplesmente essa opção no menu Conteúdo que aparecerá abaixo os botões de controle Texto, em modo de edição aparecerá o formato markdown e quando salvo aparecerá o texto formatado, vamos explicar com mais detalhes adiante. Menu Conceitos Básicos Dar Ênfase ao Texto Cabeçalhos Listas Citações Apontadores Web Quebra de Linha Barras Horizontais Código Pré-formatados /a> Uso de Carateres Especiais Referências Conceitos Básicos Para introduzir o texto simplesmente escreva na área de entrada do texto ou na caixa de texto, carregando na tecla Enter duas vezes no fim de um parágrafo para deixar uma linha em branco entre o fim de um parágrafo e o começo do seguinte. Dar Ênfase ao Texto Pode adicionar três níveis de ênfase no Markdown: texto em itálico, texto em negrito, ou texto em negrito e itálico. Isto consegue-se usando asteriscos no início e no fim do texto a enfatizar; por exemplo: *palavra* palavra **texto** texto ***palavra ou texto*** palavra ou texto A ênfase pode ser adicionada a palavras únicas, a uma sequência de palavras, ou mesmo às partes das palavras: uma palavra *única* uma palavra única ***uma sequência de palavras*** uma sequência de palavras in**distinguí**vel indistinguível
Exemplo Títulos Markdown permite subdividir o texto com títulos; estão disponíveis seis níveis diferentes, embora não seja comum que um texto normal use mais de três. Por exemplo, há três níveis de título usados no texto que está a ler atualmente. Pode-se criar um título começando uma linha com um ou vários caracteres #. Usa-se um único caracter # para o título principal, e quantos mais caracteres # usar, menos importante será o título, ou seja, menor será o tamanho de sua fonte. # título da seção ## título da sub seção ### título da sub sub seção etc. Os primeiros dois níveis de títulos são os mais comuns e podem ser criados de maneiras alternativas que as fazem sobressair na versão de texto (embora o resultado seja idêntico ao método anterior). Esta alternativa usa uma linha de sinais de iguladade (=) ou de hífenes (-) sob o título, assim: título da secção =============== título da sub secção ------------------ A figura abaixo mostra uma comparação entre o texto digitado pelo escritor e o texto apresentado na Web.
Listas Listas de pontos As listas do pontos podem ser criadas começando cada linha com um asterisco seguido por um espaço antes do conteúdo do ponto. Note que o espaço é importante e não deve ser esquecido. *primeiro ponto *segundo ponto *terceiro ponto Será apresentado assim: primeiro ponto segundo ponto terceiro ponto Listas Numeradas Similarmente, listas numeradas podem ser criadas começando cada linha com um número seguido por um espaço e o texto respectivo. 1. primeiro ponto 2. segundo ponto 3. terceiro ponto Será apresentado assim: 1. primeiro ponto 2. segundo ponto 3. terceiro ponto Listas Identadas Pode agrupar listas numeradas ou de pontos, com diferentes níveis, e até misturar listas numeradas e de pontos, usando identação: * ponto um de alto nível * sub ponto 1 * sub ponto 2 * ponto dois de alto nível 1. ponto numerado um 1. ponto numerado de nível dois 2. ponto número dois É apresentado assim: ponto um de alto nível o sub ponto 1 o sub ponto 2 ponto dois de alto nível 1. ponto numerado um 1. ponto numero de nível dois 2. ponto número dois
Citações Pode indicar uma secção que corresponde a uma citação, começando cada linha com um sinal maior que (>). Este sinal foi escolhido por ser usado frequentemente nos programas de correio electrónico para citar mensagens anteriores. A saída irá geralmente identar a secção citada dentro de ambas as margens. > Isto é um parágrafo citado > separado em duas linhas É apresentado assim: Isto é um parágrafo citado separado em duas linhas Pode poupar tempo escrevendo o sinal > unicamente no início da primeira linha do parágrafo. > Isto é uma citação num único parágrafo apesar de estar dividido em várias linhas. É apresentado assim: Isto é uma citação num único parágrafo apesar de estar dividido em várias linhas. Abaixo uma ilustração representando a citação, obeserve que é possivél combinar comandos, no caso da figura abaixo, foi inserio um título dentro da citação. Apontadores Web Há duas formas de se criar apontadores para recursos da Web: A primeira é incluir o apontador no texto, colocando o texto como um link entres chaves, e o URL (endreço web) da página destino, entre parênteses, e sem espaço entre os dois conjuntos de parênteses. Pode igualmente adicionar um título opcional para o apontador, entre aspas, seguido da URL, como no exemplo abaixo. Um [exemplo de apontador](http://www.google.com/ "Título opcional") dentro de uma frase. é convertido em: Um exemplo de apontador dentro de uma frase. O título, se fornecido, é mostrado numa janelinha quando o utilizador passar o seu mouse sobre o texto do link. Como ilustrado acima.
Para links mais compridos, ou para evitar interromper o fluxo do texto, pode usar um estilo de nota de rodapé, anexando um identificador curto num segundo conjunto de chaves (pode ser uma palavra ou frase descriptiva, ou simplesmente um número). Um [exemplo de apontador] [ex] numa frase. A seguir, em qualquer parte do documento, mas preferivelmente após o parágrafo com o link, ou então junto com outros endereços URL no fim do documento, deverá definir o endereço URL associado com o identificador: [ex]: http://www.google.com/ "Título Opcional" A saída deste segundo exemplo seria igual a do primeiro caso. É simplesmente uma maneira de manter o documento de trabalho melhor organizado para ajudar à edição (particularmente se estiver trabalhando na edição com outras pessoas). Finalmente, se quer que o texto associado ao link seja o próprio endereço URL, basta escrevé-lo entre os sinais < e > (maior e menor), como no exemplo a seguir: <http://www.google.com/> Resulta em: http://www.google.com Quebras de Linha Em alguns textos, por exemplo, na poesia e no verso, é frequentemente necessário introduzir quebras de linha. Tentar fazer isso com a tecla "enter" não dará o efeito pretendido porque por omissão as linhas juntam-se para criar um parágrafo. Por exemplo: As armas e os barões assinalados, Que da ocidental praia Lusitana, Por mares nunca de antes navegados, Passaram ainda além da Taprobana, Em perigos e guerras esforçados, Mais do que prometia a força humana, E entre gente remota edificaram Novo Reino, que tanto sublimaram; Se o texto acima fosse escrito como aparece, em linhas separadas, as mudanças de linha seriam ignoradas e o texto ficava assim: As armas e os barões assinalados, Que da ocidental praia Lusitana, Por mares nunca de antes navegados, Passaram ainda além da Taprobana, Em perigos e guerras esforçados, Mais do que prometia a força humana, E entre gente remota edificaram Novo Reino, que tanto sublimaram;
Mas terminando cada linha com dois espaços em branco, pode-se forçar uma quebra de linha e o resultado obtido será igual o exemplo demonstrado abaixo: As armas e os barões assinalados, Que da ocidental praia Lusitana, Por mares nunca de antes navegados, Passaram ainda além da Taprobana, Em perigos e guerras esforçados, Mais do que prometia a força humana, E entre gente remota edificaram Novo Reino, que tanto sublimaram; Barras Horizontais As barras horizontais podem ser criadas colocando três ou mais asteriscos (*), hífenes (-) ou underscores (_) numa linha. Isto é suficiente: *** Para se criar uma barra horizontal, mas podemos adicionar espaços ou mais caracteres para tornar mais evidente a quebra de secção na janela de edição de texto; por exemplo: * * * * * ------------------------- _ Todos estes métodos dão o mesmo exato resultado, como o separador abaixo: Código Pré-formatado /a> Se, ao contrário da secção acima, deseja que o código HTML escrito seja mostrado exatamente como foi escrito, em vez de ser processado como HTML, pode começar cada linha com quatro espaços em branco....<p>um parágrafo em <strong>html</strong> mostrado como código</p> O mesmo método (4 espaços no início da linha) pode ser usado para apresentar código de computador:...print "Argumentos da linha de Comando: (@ARGV)\n"; OBS: (aqui os 4 espaços em brancos foram representados pelo sinal de ponto. ) Como este formato é usado para listagens de programas ou outro texto que pode conter os caracteres que o Markdown usa para indicar tipos diferentes de formato, a formatação do Markdown é desligada para estas linhas:
...Normalmente esta palavra seria escrita em **negrito**. Para incluir tais caracteres dentro do texto normal, veja a seção abaixo. Uso de Caracteres Especiais Se quiser usar qualquer um dos caracteres especiais que definem o formato do Markdown sem que seja interpretado como caracter especial, simplesmente preceda-o com o carácter (\). Isto é designado de "escapar" o carácter. O carácter \ não é mostrado mas o carácter imediatamente depois dele sim, é mostrado, exatamente como introduzido. \*asteriscos, não ênfase\* É apresentado como: *asteriscos, não ênfase* em vez de *ênfase, não asteriscos* o que dá: ênfase, não asteriscos Referências O sistema Markdown não é próprio do Bimboo; é usado em um número crescente de ferramentas de publicação na Web. Pode-se obter mais informações em http://daringfireball.net/projects/markdown/