Referencia de Markdown de Microsoft Q&A
Microsoft Q&A admite una experiencia de editor web enriquecida, por lo que nunca tendrá que preocuparse por editar el contenido en Markdown. En el caso de hacerlo, esta es una referencia para escribir Markdown para Q&A.
Markdown es un lenguaje de marcado ligero con sintaxis de texto sin formato. learn.microsoft.com (Learn) admite el análisis de Markdown compatible con CommonMark mediante el motor de análisis Markdig. Learn y Q&A también admiten extensiones de Markdown personalizadas que proporcionan contenido más enriquecido en el sitio. Q&A usa un subconjunto de las extensiones admitidas en la documentación de Learn. En este artículo, se proporciona una referencia alfabética.
Puede ver más información en el artículo Referencia de Markdown de Learn.
Fragmentos de código
Cita en bloque
> This example is a blockquote. It's usually rendered indented and with a different background color.
El ejemplo anterior se representa de esta forma:
Se trata de una cita en bloque. Se representa normalmente con sangría y con un color de fondo diferente.
Bloques de código
Puede agregar el lenguaje de código a un bloque de código para una representación más enriquecida.
```csharp
public static void Log(string message)
{
_logger.LogInformation(message);
}
```
El ejemplo anterior se representa de esta forma:
public static void Log(string message)
{
_logger.LogInformation(message);
}
Emojis
Q&A convertirá un código corto de emoji en sus respectivos caracteres Unicode:
This is a test with a :).
El ejemplo anterior se representa de esta forma:
Esta es una prueba con 😃.
Formateo
Para aplicar formato de negrita al texto, enciérrelo entre dos asteriscos:
This text is **bold**.
Para aplicar formato de cursiva al texto, enciérrelo entre un solo asterisco:
This text is *italic*.
Para aplicar formato de negrita y cursiva al texto, delimítelo entre tres asteriscos:
This text is both ***bold and italic***.
Para dar formato al texto como tachado, escríbalo con dos tildes que lo rodeen:
This text is ~~strikeout~~.
encabezados
Q&A admite seis niveles 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)
- Debe haber un espacio entre el último
#y el texto del título. - Cada pregunta, respuesta o comentario debe tener uno y solo un título H1.
HTML
Si escribe contenido HTML, no se representará el contenido. En su lugar, se mostrará como texto sin formato.
Imágenes
La extensión :::image::: personalizada de Learn admite imágenes estándar, imágenes complejas e iconos.
:::image source="<folderOrURLPath>" alt-text="<alt text>":::
Donde <alt text> es una breve descripción de la imagen y <folderOrURLPath> es una ruta de acceso relativa a la imagen o su dirección URL. El texto alternativo es necesario para los lectores de pantalla de personas con discapacidad visual. También es útil si hay un error del sitio donde no se puede representar la imagen. No copie nombres de archivo para usarlos como texto alternativo. Por ejemplo, en lugar de esto:
:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="ADextension_2FA_Configure_Step4":::
Escriba esto:
:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="Active Directory extension for two-factor authentication, step 4: Configure":::
Vínculos
Los vínculos son fáciles de agregar en Q&A. Los vínculos apuntan a los usuarios al contenido de otra página en Q&A u otro origen de confianza.
[Link text](<FullURL>).
[Microsoft Q&A products page](/answers/products).`
Texto del vínculo
Las palabras que incluya en el texto del vínculo deben ser descriptivas. Es decir, deben ser palabras normales en español o el título de la página a la que remite el vínculo.
No use "Seleccionar aquí" para "Texto del vínculo". No se trata de un texto conveniente para la optimización del motor de búsqueda ni describe correctamente el destino.
Importante
Todos los vínculos deben estar protegidos (https frente a http) siempre que el destino lo admita (lo que la inmensa mayoría debería hacer).
Ejemplo:
For more information, see the [Microsoft Q&A products page](/answers/products).
El ejemplo anterior se representa como:
Para obtener más información, consulte la página del producto de Microsoft Q&A.
Vínculos automáticos
Los vínculos se formatearán automáticamente para cualquier cadena que comience por: https://, https://, ftp://, mailto:, tel: o www. (se resuelve en https://www).
Listas (numeradas, con viñetas)
Lista numerada
Para crear una lista numerada, puede usar todo números 1. Los números se representarán en orden ascendente como una lista secuencial cuando se publiquen. Para aumentar la legibilidad del texto, puede aumentar manualmente las listas.
No use letras en las listas, ni siquiera en las anidadas, No se representan correctamente cuando se publican. Las listas anidadas en las que se usan números se representarán como letras en minúscula al publicarse. Por ejemplo:
1. This is
1. a parent numbered list
1. and this is
1. a nested numbered list
1. (fin)
Esto se representa de la forma siguiente:
- This is
- una lista numerada primaria
- and this is
- a nested numbered list
- (fin)
Lista de viñetas
Para crear una lista con viñetas, use - o * seguido de un espacio al principio de cada línea:
- This is
- a parent bulleted list
- and this is
- a nested bulleted list
- All done!
Esto se representa de la forma siguiente:
- This is
- una lista con viñetas primaria
- and this is
- a nested bulleted list
- ¡Listo!
Cualquier sintaxis que use, - o *, úsela de forma coherente en el contenido.
Tablas
La forma más sencilla de crear una tabla en Markdown es usar barras verticales y líneas. Para crear una tabla estándar con un encabezado, siga la primera línea con una línea discontinua:
|This is |a simple |table header|
|----------|-----------|------------|
|table |data |here |
|it doesn't|actually |have to line up nicely!|
Esto se representa de la forma siguiente:
| This is | a simple | table header |
|---|---|---|
| table | datos | aquí |
| it doesn't | actually | have to line up nicely! |