Referência de marcação de perguntas e respostas da Microsoft
As Perguntas e Respostas da Microsoft suportam uma experiência de editor web avançada, para que nunca tenha de se preocupar com a edição do conteúdo no Markdown. No caso de o fazer, aqui está uma referência para escrever Markdown para P&R.
A Markdown é uma linguagem de markup simples com sintaxe de formatação de texto simples.
learn.microsoft.com
(Learn) suporta Markdown compatível com CommonMark analisado através do mecanismo de análise Markdig . O Learn and Q&A também suporta extensões de Markdown personalizadas que fornecem conteúdo mais rico no site. As Perguntas e Respostas usam um subconjunto das extensões suportadas na documentação do Learn. Este artigo fornece uma referência alfabética.
Você pode ver mais informações no artigo de referência do Learn Markdown.
Fragmentos de código
Bloquear cotação
> This example is a blockquote. It's usually rendered indented and with a different background color.
O exemplo anterior é composto da seguinte forma:
Trata-se de um trecho em bloco. Geralmente é renderizado recuado e com uma cor de fundo diferente.
Blocos de código
Você pode adicionar a linguagem de código a um bloco de código para renderização mais rica.
```csharp
public static void Log(string message)
{
_logger.LogInformation(message);
}
```
O exemplo anterior é composto da seguinte forma:
public static void Log(string message)
{
_logger.LogInformation(message);
}
Emojis
P&R irá converter um código curto emoji para seus respetivos caracteres Unicode:
This is a test with a :).
O exemplo anterior é composto da seguinte forma:
Este é um teste com um 😃arquivo .
Formatação
Para colocar o texto a negrito, coloque dois asteriscos antes e depois do mesmo:
This text is **bold**.
Para colocar o texto em itálico, coloque um asterisco antes e depois do mesmo:
This text is *italic*.
Para colocar o texto a negrito e em itálico, coloque três asteriscos antes e depois do mesmo:
This text is both ***bold and italic***.
Para formatar o texto como riscado, coloque-o com dois ao redor dele por dois tils:
This text is ~~strikeout~~.
Cabeçalhos
As Perguntas e Respostas suportam seis níveis de títulos de Markdown:
# This is a first level heading (H1)
## This is a second level heading (H2)
...
###### This is a sixth level heading (H6)
- Tem de existir um espaço entre o último
#
e o texto do cabeçalho. - Cada pergunta, resposta ou comentário deve ter um único título H1.
HTML
Se você inserir conteúdo HTML, o conteúdo não será renderizado. Em vez disso, ele será exibido como texto sem formatação.
Imagens
A extensão personalizada :::image:::
do Learn suporta imagens padrão, imagens complexas e ícones.
:::image source="<folderOrURLPath>" alt-text="<alt text>":::
Onde <alt text>
é uma breve descrição da imagem e <folderOrURLPath>
é um caminho relativo para a imagem ou seu URL. A utilização de texto alternativo é obrigatória para leitores de ecrã de pessoas com dificuldades visuais. Também é útil se ocorrer um erro de site onde a imagem não pode ser composta. Não copie nomes de arquivo para uso como texto alternativo. Por exemplo, em vez disto:
:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="ADextension_2FA_Configure_Step4":::
Escreva isto:
:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="Active Directory extension for two-factor authentication, step 4: Configure":::
Ligações
Os links são fáceis de adicionar em P&R. Os links direcionam os usuários para o conteúdo de outra página em P&R ou outra fonte confiável.
[Link text](<FullURL>).
[Microsoft Q&A products page](/answers/products).`
Texto da ligação
As palavras que você incluir no texto do link devem ser amigáveis. Por outras palavras, devem ser utilizados termos normais em português ou o título da página para o qual está a criar a ligação.
Não use "selecionar aqui." para o "Texto do link". Não é útil para otimização do motor de busca e não descreve adequadamente o texto de destino.
Importante
Todas as ligações têm de ser seguras (https
vs http
) sempre que o destino o suportar (sendo que a grande maioria deve fazê-lo).
Exemplo:
For more information, see the [Microsoft Q&A products page](/answers/products).
O exemplo acima renderiza como:
Para obter mais informações, consulte a página de produtos de Perguntas e Respostas da Microsoft.
Ligações automáticas
Os links serão formatados automaticamente para qualquer cadeia de caracteres que comece por: https://
, https://
, ftp://
, mailto:
, tel:
, ou www.
(resolve para https://www
.)
Listas (numeradas, com marcadores)
Lista numerada
Para criar uma lista numerada, pode usar todos os "1s". Os números são compostos por ordem ascendente como uma lista sequencial quando são publicados. Para maior legibilidade da fonte, você pode aumentar suas listas manualmente.
Não utilize letras em listas, incluindo em listas aninhadas. Eles não são renderizados corretamente quando publicados. As listas aninhadas que utilizam números serão compostas como letras minúsculas quando forem publicadas. Por exemplo:
1. This is
1. a parent numbered list
1. and this is
1. a nested numbered list
1. (fin)
Isto é composto da seguinte forma:
- This is
- uma lista numerada pai
- and this is
- a nested numbered list
- (fin)
Lista com marcas
Para criar uma lista com marcas, utilize -
ou *
seguido de um espaço no início de cada linha:
- This is
- a parent bulleted list
- and this is
- a nested bulleted list
- All done!
Isto é composto da seguinte forma:
- This is
- uma lista com marcadores pai
- and this is
- a nested bulleted list
- E já está!
Seja qual for a sintaxe que utilizar, -
ou *
, utilize-a de forma consistente no seu conteúdo.
Tabelas
A forma mais fácil de criar uma tabela em Markdown é através de barras verticais e hífenes. Para criar uma tabela padrão com um cabeçalho, siga a primeira linha tracejada:
|This is |a simple |table header|
|----------|-----------|------------|
|table |data |here |
|it doesn't|actually |have to line up nicely!|
Isto é composto da seguinte forma:
This is | a simple | table header |
---|---|---|
tabela | dados | aqui |
it doesn't | actually | have to line up nicely! |