Traduzido do 日本語 • Ver original O DEVLAB foi revisado e transformado em um blog oficial de forma séria como IsaB, e o número de pessoas que escrevem artigos deve aumentar no futuro, então transcrevi este post como um protótipo da notação Markdown para este blog e como um documento de boas-vindas para confirmar o estilo de exibição.
O que é a notação markdown afinal? ── Pode haver muitas pessoas que digam,
Markdown é uma das linguagens de marcação mais leves para escrever documentos. Foi originalmente desenvolvido para gerar HTML a partir de documentos escritos facilmente em formato de texto simples. Atualmente, além do HTML, softwares (conversores) que convertem em arquivos nos formatos PowerPoint e LATEX também estão sendo desenvolvidos. Como várias extensões são feitas pelos desenvolvedores de cada conversor, existem vários dialetos.
O acima é uma citação da Wikipédia.
Bem, simplificando, é um método de escrita que pode ser convertido em documentos HTML com estilo rico escrevendo frases de texto em um formato que segue as regras, mesmo que você não saiba HTML. Se você memorizar até o formato básico, pode convertê-lo para vários formatos, então é uma habilidade linguística vantajosa que pode ser usada em várias situações.
──Então, vou apresentar o formato básico imediatamente.
1. Bloqueios de Rumo
Primeiro, vamos começar com como escrever um bloco de cabeçalho. Em princípio, no caso dos elementos do bloco, quebras de linha são necessárias antes e depois.
# Rumo H1
## Rumo H2
### Rumo H3
#### Rumo H4
##### Rumo H5
###### Rumo H6
O que isso parece é
Rumo H1
Rumo H2
Rumo H3
Rumo H4
Rumo H5
Rumo H6
↑ Vai ser assim.
Apenas H1 e H2 têm notações diferentes,
Rumo H1
===============
Rumo H2
---------------
↑ Você também pode usar algo assim. O número de = e - na linha imediatamente após o título é aceitável, desde que seja maior de um. Isso facilita a visualização do texto mesmo em um estado de texto onde markdown não está com estilo.
Você também pode usar hashes em títulos para alcançar links dentro da página (esta é uma extensão do Markdown Extra. Está disponível neste site). Nesse caso, adicione '{#hash}' após o título.
### Títulos hashados {#hash}
Títulos Hash
Para notação de links na página para títulos hash, veja a seção de links abaixo.
2. Bloco de citações
Como é um elemento de bloco, ele precisa ser relineado.
> Contém o texto da citação.
Contém o texto da citação.
A criação de ninhos também é possível.
> Citações de aninhamento
>
> - Conteúdo que é um elemento filho
> - Conteúdo que é um elemento filho
>
Citações de aninhamento
- Conteúdo que é um elemento filho
- Conteúdo que é um elemento filho
3. Blocos de Código
Como é um elemento de bloco, ele precisa ser relineado.
\`\`\`
função is_assoc( & $data ) {
if (!is_array($data))
retorne falso;
return !vty(array_diff( array_keys($data), range(0, count($data) - 1) ));
}
\`\`\`
↓ Será exibido assim.
função is_assoc( & $data ) {
if (!is_array($data))
retorne falso;
return !vty(array_diff( array_keys($data), range(0, count($data) - 1) ));
}
4. Código Inline
Como é um elemento em linha, não há necessidade de quebras de linha antes e depois.
O código inline parece \'is_assoc()\'←.
O código inline é 'is_assoc()' ← fica assim.
5. Lista aleatória
- Lista 1
- Lista 2
- Lista de Ninhos 1
- Nestlist 2
- Lista 3
Lista 1
Lista 2
- Lista de Ninhos 1
- Nestlist 2
Lista 3
6. Listas Numeradas
1. Lista 1
1. Lista 2
1. Lista de Ninhos 1
1. Lista de Ninhos 2
1. Lista 3
Lista 1
Lista 2
- Lista de Ninhos 1
- Lista de Ninhos 2
Lista 3
7. Ênfase no texto
Como é um elemento em linha, não há necessidade de quebras de linha antes e depois.
Se quiser enfatizar, **isso fará** o texto ser mais forte e enfatizado.
Se quiser enfatizar, isso fará com que as letras fiquem em negrito e enfatizem.
Se quiser colocar itálico em caracteres alfanuméricos, etc., se usar *Abc*, as letras serão exibidas em itálico, como _123_.
Se quiser colocar itálico em caracteres alfanuméricos, etc., se usar Abc, as letras serão exibidas em itálico, como 123.
8. link
Como é um elemento em linha, não há necessidade de quebras de linha antes e depois.
[Cordas exibidas](#hash "title属性値")
Você pode usar [o link no](http://www.google.com/ "google TOP") texto assim.
Você pode usar o link no texto assim.
O valor do atributo título é opcional, então não tem problema simplesmente usá-lo como [um topo do Yahoo!](http://yahoo.co.jp).
O valor do atributo título é opcional, então não tem problema simplesmente usá-lo como um topo do Yahoo!.
9. Colar uma imagem
Você também pode colar imagens.
{#id .class}
Quando o formato acima é convertido para HTML,
<img src="画像ファイルのURL" alt="alt属性値" title="title属性値" id="id" class="class">
──. Como aplicação, vou postar um exemplo de como posicionar imagens como esquerda, centro e direita usando a classe bootstrap usada neste site.
{.puxe à esquerda}
Você pode enrolar o texto para o lado direito.<div class="clearfix"></div>
{.bloco central}
{.puxe para a direita}
Você pode mover o texto para a esquerda.<div class="clearfix"></div>```
↓
 Você pode enrolar o texto para o lado direito.
 Você pode mover o texto para a esquerda.
De desfazer o loop'<div class="clearfix"></div>O lado negativo é que será necessário, mas acho que é fácil de usar.
## Diversos
Além disso, é útil conhecer as características dos quebras de linha. O markdown quebra corretamente quebras de linha no final das frases, mas mesmo que você use uma linha em branco em uma linha, apenas uma linha em branco será eficaz. Em outras palavras,
Daqui,
Quero dividir a linha em três linhas.
──, mas na realidade,
Daqui,
Quero dividir a linha em três linhas.
── e apenas uma linha em branco pode ser inserida. Se quiser adicionar mais quebras de linha, faça o seguinte.
Daqui,
Quero dividir a linha em três linhas.
Daqui,
Quero dividir a linha em três linhas.
Se você mudar o estilo inline '3em' na tag 'div' por um número para o número de linhas que deseja quebrar, pode colocar quantos quebramentos de linha quiser. Bem, incorporar tags diretamente é uma tendência que vai contra a semântica do 'markdown', mas é um mal necessário escrever posts de blog de forma fácil de ler.
Existem muitas outras anotações para decoração de caracteres, mas basicamente só de conhecer a notação apresentada aqui pode ajudar você a escrever um artigo muito mais completo. Se você se interessa por outras notações, pode procurar palavras-chave como 'markdown' na Internet, e encontrará muitas delas, então por favor, consulte-as.
Uma coisa a notar no WordPress é que, ao escrever um artigo em notação markdown, você precisa definir o modo de edição de posts para "Texto". Se você esquecer isso e escrever no modo visual, a conversão markdown não será aplicada.