> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/es/articulos-en-profundidad/30-how-to-write-in-markdown-on-overleaf.md).
# Cómo escribir en Markdown en Overleaf
**Actualización posterior a la publicación** (añadido el 13 de mayo de 2017): Agradecemos a Vít Novotný, el autor/mantenedor del `markdown` paquete, por escribirnos con algunos comentarios útiles sobre el artículo original. Nos complace publicar esta versión actualizada, que tiene en cuenta e incluye sus consejos y sugerencias.
### ¿Eh, qué?
[Markdown](https://kirkstrobeck.github.io/whatismarkdown.com/) es un lenguaje de marcado ligero (¿lo pillas? 😉) que te permite escribir algo en texto plano con unas *muy* reglas sencillas, y luego transformarlo en salidas formateadas, p. ej., HTML. Es muy popular entre desarrolladores y programadores de software, precisamente por su simplicidad (¡y, además, puedo añadir, que también es perfecto para tomar notas!).
Por ejemplo, para escribir una lista de la compra rápida:
```
# Lista de la compra
*Recuerda* coger todo lo que podamos durante las próximas [rebajas](http://acme-marg.com)!
## Comida
- frijoles horneados
- espaguetis
## Papelería
- bloc de notas
- lápices
```
Y obtendrás como salida HTML, usando una herramienta como [pandoc](http://pandoc.org/):
```html
Lista de la compra
Recuerda coger todo lo que podamos durante las próximas rebajas!
Comida
- frijoles horneados
- espaguetis
Papelería
```
¡Bonito y sencillo! Puedes encontrar otra sintaxis para Markdown [aquí](https://daringfireball.net/projects/markdown/syntax).
### ¿Y esto qué significa para mí?
Muchos usuarios de LaTeX están satisfechos con sus hermosos documentos compuestos en LaTeX, pero no pueden evitar sentir un pellizco de envidia hacia los usuarios de Markdown, porque, bueno, el marcado de LaTeX *puede* puede llegar a ser bastante verboso a veces. Sí, listas, os estamos mirando a *vosotras*...
La buena noticia es que el fantástico nuevo [`markdown` paquete de LaTeX](https://ctan.org/pkg/markdown) te permite escribir sintaxis markdown en tus documentos de LaTeX (es decir, entradas más sencillas) y aun así obtener PDFs bellamente compuestos. Todo lo que tienes que hacer es cargar el `markdown` paquete en tu documento, y encerrar tu material Markdown dentro de un `markdown` entorno:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\begin{markdown}
# Lista de la compra
*Recuerda* coger todo lo que podamos durante las próximas [rebajas](http://acme-marg.com)!
## Comida
- frijoles horneados
- espaguetis
## Papelería
- bloc de notas
- lápices
\end{markdown}
\end{document}
```
O, si prefieres poner tu material Markdown en un `*.md` archivo:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\markdownInput{example.md}
\end{document}
```
¡Genial! Esto probablemente hará muy felices a los tipos desarrolladores, porque ahora pueden simplemente copiar su `.md` ¡documentación!
### ¿Puedo seguir usando comandos de LaTeX si escribo Markdown?
Sí, ¡todavía puedes usar comandos de LaTeX en tu material Markdown! Solo pasa la `híbrida` opción a `markdown`:
```latex
\usepackage[hybrid]{markdown}
...
- bloc de notas (del tipo con el gran $E=mc^2$ en la portada)
```
### ¿Cómo puedo usar caracteres literales como '#' y '\_' (guiones bajos)?
#### Escribir un '#'
No puedes escribir el carácter '#' *dentro del `markdown` entorno*. Ni siquiera `\#` funcionará. Necesitas definir un comando como `\newcommand{\texthash}{\#}`, y luego usar `\texthash` en tu `markdown` entorno. De forma similar para los guiones bajos, especialmente cuando hay más de uno en la misma línea, p. ej., `$y = m_1 + n_2$`. A veces puede ser más fácil terminar el `markdown` entorno actual y escribir las líneas problemáticas en modo LaTeX normal, y luego comenzar otro `markdown` entorno.
#### Escribir '\_' (guion bajo) y '\`' (acento grave)
**Actualización** (añadido el 13 de mayo de 2017): Desde `markdown` la versión 2.5 puedes establecer `underscores = false` y `codeSpans = false` para desactivar los guiones bajos y los acentos graves. Esto hace posible escribir subíndices matemáticos y comillas en modo híbrido sin escapar caracteres. Tenemos asteriscos para el énfasis, así que lo único que realmente se pierde son los ejemplos de código en línea. ¡Gracias, Vít, por el consejo!
#### Entornos que evitar...
Y aunque puedes usar acentos graves para escribir texto literal en línea, o sangrar la línea con cuatro espacios para un bloque literal, no uses `lstlisting` ni `minted` entornos de LaTeX dentro de `markdown` entornos. Simplemente no lo hagas.
#### Uso de HTML en un entorno markdown
Y no, no puedes usar HTML dentro del `markdown` entorno de LaTeX (aunque esto es algo habitual en Markdown). Lo siento.
**Actualización** (añadido el 13 de mayo de 2017): A partir de `markdown` v2.3, hay una `html` opción que no mostrará las etiquetas HTML literalmente si están presentes en tu material markdown, aunque tampoco formateará realmente el contenido de las etiquetas; es decir, `¡Hola!` solo mostrará Hola! con el peso normal. Pero las entidades HTML como `©` se mostrarán como ©. Gracias a Vít por señalar esto.
### Opciones sugeridas del paquete markdown
Un conjunto de `markdown` opciones del paquete que quizá te resulten útiles es:
```latex
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses,hybrid]{markdown}
```
Estas opciones permiten usar
* la sintaxis markdown de notas al pie (como `[^1]`);
* listas de definiciones y `#` para listas numeradas;
* puntos suspensivos «correctos» (…).
Aquí tienes un [ejemplo completo](https://www.overleaf.com/latex/examples/using-markdown-in-latex-documents/whdrnpcpnwrm) en la galería de Overleaf, y aquí hay [otro](https://www.overleaf.com/articles/how-to-write-using-rich-text-format-and-markdown-in-latex-and-overleaf/dbqrxvftzskw).
### Hipervínculos y notas al pie: ¿cómo?
En el ejemplo de Overleaf, el hipervínculo es una nota al pie. ¿Cómo consigo que sea un hipervínculo de hyperref?
`markdown` es personalizable, así que puedes definir cómo te gustaría que se representaran los distintos elementos. Añadir esto a tu preámbulo hará exactamente eso:
```latex
\markdownSetup{renderers={
link = {\href{#2}{#1}}
}}
```
**Actualización** (añadido el 13 de mayo de 2017): `rendererPrototypes` se utilizó en la versión inicial. Se recomienda a los usuarios normales usar `renderers` para sus propias definiciones, ya que `rendererPrototypes` está ahí para que los creadores del paquete proporcionen valores predeterminados. Si modificas `rendererPrototypes`, corres el riesgo de que otro paquete sobrescriba tus ajustes. ¡Gracias a Vít por señalar esto!
### Incluir imágenes (actualizado el 8 de noviembre de 2022)
* **Nota**: El siguiente ejemplo usa un archivo gráfico (`example-image.pdf`) proporcionado por el `mwe` paquete. Esos archivos gráficos se distribuyen con TeX Live y, por lo tanto, están almacenados en los servidores de Overleaf, lo que los hace disponibles como marcadores de posición de imagen, como en el siguiente ejemplo.
Las imágenes pueden incluirse en markdown escribiendo una sintaxis con el siguiente formato:
```latex
```
Con suerte, los nombres de los parámetros `texto alternativo`, `nombre-de-archivo` y `"pie de imagen"` describen lo que hacen. Aquí hay un ejemplo para demostrarlo:
```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
% El paquete mwe proporciona imágenes de ejemplo. Cargarlo
% no es esencial porque esas imágenes están en la ruta de búsqueda de LaTeX.
% Aquí lo cargamos para mayor claridad en este ejemplo.
\usepackage{mwe}
\begin{document}
\begin{markdown}
Este ejemplo muestra cómo importar un archivo gráfico. Aquí estamos usando una
imagen de ejemplo proporcionada por el paquete `mwe`.
% Usa \setkeys{Gin} si necesitas cambiar el tamaño de visualización de una imagen
\setkeys{Gin}{width=.5\linewidth}
\end{markdown}
\end{document}
```
[Abre este ejemplo en Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+images+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bhybrid%5D%7Bmarkdown%7D%0A%25+The+mwe+package+provides+example+images.+Loading+it+is%0A%25+not+essential+because+those+images+are+in+LaTeX%27s+search+path.+%0A%25+Here%2C+we+load+it+for+clarity+in+this+example.%0A%5Cusepackage%7Bmwe%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0AThis+example+shows+how+to+import+a+graphics+file.+Here+we+are+using+an%0Aexample+image+provided+by+the+%60mwe%60+package.%0A%0A%25+Use+%5Csetkeys%7BGin%7D+if+you+need+to+change+an+image%27s+display+size%0A%0A%5Csetkeys%7BGin%7D%7Bwidth%3D.5%5Clinewidth%7D%0A%21%5BThis+is+alt+text+to+describe+my+image.%5D%28example-image.jpg+%22An+example+image+provided+by+the+%5Ctexttt%7Bmwe%7D+package.%22%29%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)
Este ejemplo produce la siguiente salida:
#### Nota sobre el ancho de la imagen
Como la mayoría de los paquetes, `markdown` carga otros paquetes, incluido [`keyval`](https://ctan.org/pkg/keyval?lang=en) y [`graphicx`](https://ctan.org/pkg/graphicx?lang=en), para hacer uso de los comandos y funciones que proporcionan. Aquí, el ancho de la imagen se establece usando el `\setkeys` comando, que es proporcionado por `keyvals`. `Gin` es una "familia" de claves definida por el `graphicx` paquete.
* **Nota**: Debido a que se usa un comando de LaTeX, aquí `\setkeys`, *dentro* la `markdown` del entorno, se requiere la `híbrida` opción del paquete markdown.
#### Cambiar los identificadores de colocación de flotantes (más avanzado)
La sintaxis markdown para incluir figuras no te permite especificar directamente los identificadores de colocación de flotantes, pero puedes ajustarlos redefiniendo cómo se representa la figura:
```latex
\markdownSetup{renderers={
image = {\begin{figure}[hbt!]
\centering
\includegraphics{#3}%
\ifx\empty#4\empty\else
\caption{#4}%
\fi
\end{figure}}
}}
```
Para más información, consulta la [documentación de markdown](https://mirror.apps.cam.ac.uk/pub/tex-archive/macros/generic/markdown/markdown.html).
### ¿Puedes crear tablas usando markdown en LaTeX? 😀
Por desgracia, no. Las tablas solo son compatibles con [MultiMarkdown](http://fletcherpenney.net/multimarkdown/) y el paquete de LaTeX `markdown` no lo admite actualmente.
**Actualización** (añadido el 13 de mayo de 2017): Basándose en un consejo de Vít, es posible usar la `extensión de sintaxis contentBlocks` desde la versión 2.4, o ajustar el `renderer inputFencedCode` para convertir rápidamente algún texto con formato CSV en una tabla.
### ¿Más bondades del paquete markdown...?
Como se mencionó antes, es una forma genial de tomar notas, y cuando se combina con unas buenas clases de documento LaTeX o configuraciones de paquetes, te permite tener al final de una clase un cuaderno precioso. Por ejemplo, podrías usarlo con las [clases Tufte](https://www.overleaf.com/gallery/tagged/tufte):
```latex
\documentclass{tufte-handout}
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses, hybrid]{markdown}
\begin{document}
\markdownInput{PHY303-lecture-12Nov2016.md}
\end{document}
```
Y la sintaxis corta y sencilla que hace que escribir listas sea mucho más cómodo significa que ahora tenemos una *realmente rápida* forma de escribir [presentaciones Beamer](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw) y [pósteres](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw)!
¡Diviértete!
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://overleaf-pro.ayaka.space/latex/es/articulos-en-profundidad/30-how-to-write-in-markdown-on-overleaf.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.