Cursos
Módulo
Póngase en contacto de manera eficaz en GitHub con Markdown - Training
Aprenderemos a usar Markdown para comunicarnos de forma breve, clara y expresiva.
Este explorador ya no se admite.
Actualice a Microsoft Edge para aprovechar las características y actualizaciones de seguridad más recientes, y disponer de soporte técnico.
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.
> 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.
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);
}
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 😃.
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~~.
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)
#
y el texto del título.Si escribe contenido HTML, no se representará el contenido. En su lugar, se mostrará como texto sin formato.
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":::
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).`
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.
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
).
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:
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:
Cualquier sintaxis que use, -
o *
, úsela de forma coherente en el contenido.
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! |
Cursos
Módulo
Póngase en contacto de manera eficaz en GitHub con Markdown - Training
Aprenderemos a usar Markdown para comunicarnos de forma breve, clara y expresiva.