Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

i18n(es): update markdown-content.md #1941

Merged
merged 5 commits into from
Oct 31, 2022
Merged

i18n(es): update markdown-content.md #1941

Changes from 2 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
a8a9110
i18n(es): add docs for alternative markdown file extensions
fredoist Oct 28, 2022
51b2f0e
i18n(es): document how to escape special characters in markdown
fredoist Oct 28, 2022
4c6bfa7
i18n(es): apply review suggestions
fredoist Oct 31, 2022
2aa4c1a
i18n(es): document how to use a custom Shiki theme (#1749)
fredoist Oct 31, 2022
efcf0fc
Merge branch 'main' into markdown-content.md
kevinzunigacuellar Oct 31, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 13 additions & 9 deletions src/pages/es/guides/markdown-content.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,15 @@ description: Aprende a crear contenido usando Markdown o MDX en Astro
i18nReady: true
---

El [Markdown](https://daringfireball.net/projects/markdown/) se usa comúnmente para crear contenido con mucho texto, como artículos de blog y documentación. Astro incluye soporte integrado para archivos estándar de Markdown (`.md`).
El [Markdown](https://daringfireball.net/projects/markdown/) se usa comúnmente para crear contenido con mucho texto, como artículos de blog y documentación. Astro incluye soporte integrado para archivos estándar de Markdown (`.md`, `.markdown`, `.mdown`, `.mkdn`, `.mkd`, `.mdwn`).

Con la [integración @astrojs/mdx](/es/guides/integrations-guide/mdx/) instalada, Astro también soporta archivos [MDX](https://mdxjs.com/) (`.mdx`) los cuales poseen algunas características adicionales como soporte para expresiones JavaScript y componentes en un contenido Markdown.

¡Utiliza cualquiera de ambos (o ambos) para escribir tu contenido Markdown!

## Páginas de Markdown y MDX

Astro trata cualquier archivo `.md` o `.mdx` dentro de la carpeta `/src/pages` como una página. Al colocar un archivo en esta carpeta, o en cualquier subcarpeta, se creará automáticamente una ruta de página utilizando la ruta del archivo.
Astro trata cualquier archivo `.md` (u otra extensión alternativa soportada) o `.mdx` dentro de la carpeta `/src/pages` como una página. Al colocar un archivo en esta carpeta, o en cualquier subcarpeta, se creará automáticamente una ruta de página utilizando la ruta del archivo.

📚 Obtén más información sobre [enrutamiento basado en archivos](/es/core-concepts/routing/) en Astro.

Expand Down Expand Up @@ -160,7 +160,7 @@ Astro.props = {

#### Ejemplo: Utilizando una plantilla para archivos `.md`, `.mdx` y `.astro`

Puedes escribir una plantilla de Astro para recibir el objeto `frontmatter` de archivos `.md` y `.mdx`, como así también cualquier otra prop pasada desde archivos `.astro`.
Puedes escribir una plantilla de Astro para recibir el objeto `frontmatter` de archivos `.md` (o `.markdown` etc.) y `.mdx`, como así también cualquier otra prop pasada desde archivos `.astro`.

En el siguiente ejemplo, la plantilla mostrará el título de la página, ya sea desde un componente Astro pasando un atributo `title` o de una propiedad `title` del YAML de un frontmatter:

Expand All @@ -186,7 +186,7 @@ Estas identificaciones se agregarán _después_ de que se ejecuten todos los dem

### Borradores en Markdown

`draft: true` es un valor opcional que marcará una página o artículo individual `.md` como "borrador". De forma predeterminada, esta página se excluirá de la compilación final de su proyecto.
`draft: true` es un valor opcional que marcará una página o artículo individual `.md` (o `.markdown` etc.) como "borrador". De forma predeterminada, esta página se excluirá de la compilación final de su proyecto.

Las páginas de Markdown sin la propiedad `draft` o aquellas con `draft: false` no se verán afectadas y se incluirán en la compilación final.

Expand Down Expand Up @@ -236,10 +236,16 @@ export default defineConfig({
¡También puedes agregar la extensión `--drafts` al ejecutar `astro build` para incluir la creación de páginas borrador!
:::

### Escapando caracteres especiales

Ciertos caracteres tienen un significado especial en Markdown y MDX. Puedes necesitar usar una sintaxis diferente si deseas mostrarlos. Para hacer esto, puedes usar [entidades HTML](https://developer.mozilla.org/es/docs/Glossary/Entity) para esos caracteres en su lugar.

Por ejemplo, para prevenir `<` de ser interpretado como el inicio de un elemento HTML, escribe `&lt;`. O, para prevenir `{` de ser interpretado como el inicio de una expesión de JavaScript en MDX, escribe `&lcub;`.
fredoist marked this conversation as resolved.
Show resolved Hide resolved

### Variables y Componentes

:::caution[Deprecated]
Astro v1.0 **solamente admite Markdown estándar en archivos `.md`**. [Ya no admite componentes o JSX en las páginas de Markdown de forma predeterminada](/es/migrate/#deprecado-componentes-y-jsx-en-markdown) y es posible que se elimine en una versión futura.
Astro v1.0 **solamente admite Markdown estándar en archivos `.md` (o `.markdown` etc.)**. [Ya no admite componentes o JSX en las páginas de Markdown de forma predeterminada](/es/migrate/#deprecado-componentes-y-jsx-en-markdown) y es posible que se elimine en una versión futura.

Mientras tanto, la configuración de Astro admite una [legacy flag](/es/reference/configuration-reference/#legacyastroflavoredmarkdown) que reactivará estas funcionalidades en páginas de Markdown hasta que pueda migrar a MDX en Astro. La integración de MDX en Astro es el camino recomendado si deseas agregar más funcionalidades que las que provee el estándar de Markdown.
:::
Expand All @@ -250,7 +256,7 @@ Por favor instala la integración oficial [`@astrojs/mdx`](/es/guides/integratio

- [componentes de Astro](/es/core-concepts/astro-components/) or [components de framework](/es/core-concepts/framework-components/) en archivos MDX (`.mdx`).

Consulta la guía de migración para obtener ayuda [con la conversión de tus archivos Astro `.md` a `.mdx`](/es/migrate/#convertir-archivos-md-a-mdx).
Consulta la guía de migración para obtener ayuda [con la conversión de tus archivos Astro `.md` (o `.markdown` etc.) a `.mdx`](/es/migrate/#convertir-archivos-md-a-mdx).

## Características de MDX

Expand All @@ -260,14 +266,12 @@ Astro incluye soporte completo para MDX mediante la integración oficial `@astro

Con la integración `@astrojs/mdx`, puedes utilizar [variables y expresiones JSX en archivos MDX (`.mdx`)](/es/guides/integrations-guide/mdx/#variables).


### Usando Componentes en MDX

Con la integración `@astrojs/mdx`, puedes usar tus componentes Astro o de framework en archivos MDX (`.mdx`) de la misma forma que los [usarías en cualquier otro componente de Astro](/es/core-concepts/framework-components/#usando-componentes-de-otros-frameworks).

¡No olvides agregar una directiva `client:` si es necesario!


## Importando Markdown

¡Puedes importar archivos Markdown directamente en sus archivos Astro! Puedes importar una página específica con `import` o varias con `Astro.glob()`
Expand Down Expand Up @@ -532,7 +536,7 @@ const { minutesRead } = Astro.props.frontmatter;

Astro viene con soporte integrado para [Shiki](https://shiki.matsu.io/) y [Prism](https://prismjs.com/). Esto proporciona un resaltado de sintaxis instantáneo para:

- todas las vallas de código (\`\`\`) usadas en los archivos markdown (`.md`).
- todas las vallas de código (\`\`\`) usadas en los archivos markdown (`.md` o `.markdown` etc.).
- el contenido dentro del [componente `<Code />`](/es/reference/api-reference/#code-) (con la tecnología de Shiki), o el [componente `<Prism />`](/es/reference/api-reference/#prism-) (con la tecnología de Prism).

Shiki está habilitado de forma predeterminada, preconfigurado con el tema `github-dark`. La salida compilada se limitará a estilos en línea sin clases CSS externas, hojas de estilo o JS del lado del cliente.
Expand Down