> 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/32-markdown-into-latex-with-style.md). # Markdown a LaTeX con estilo **Actualización posterior a la publicación** (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 toma nota de, e incluye, sus consejos y sugerencias. ### Introducción Hace un tiempo nos alegramos por el lanzamiento del [`paquete markdown`](http://www.ctan.org/pkg/markdown) que permitió escribir sintaxis markdown en documentos de LaTeX—y lo celebramos con un artículo llamado [Cómo escribir en Markdown en Overleaf](/latex/es/articulos-en-profundidad/30-how-to-write-in-markdown-on-overleaf.md) cuyo propósito era demostrar parte de la sintaxis admitida. **Recuerde**: Tendrá que compilar sus `.tex` archivos con la `--shell-escape` opción para que funcione en instalaciones locales de LaTeX—Overleaf lo hace por usted (automáticamente). Tenga en cuenta que la mayoría de los portales de envío de revistas no habilitan `--shell-escape`—a menos que se le permita subir solo el PDF de salida de su manuscrito, es posible que sus archivos LaTeX que contienen markdown no se compilen correctamente cuando sean procesados por el sistema de envío de la editorial. Una de las ideas insinuadas en el [artículo anterior](/latex/es/articulos-en-profundidad/30-how-to-write-in-markdown-on-overleaf.md) es que una combinación de markdown y LaTeX permite una maravillosa separación entre contenido y estilo. Los autores (especialmente los ya familiarizados con markdown) tendrían una sintaxis mucho más concisa con la que trabajar (con algunas salvedades) y, al mismo tiempo, seguirían teniendo acceso a todas las maravillas de los paquetes y plantillas de LaTeX para encargarse del estilo y el formato. Esa [artículo anterior](/latex/es/articulos-en-profundidad/30-how-to-write-in-markdown-on-overleaf.md) dio algunos ejemplos de uso de markdown en [presentaciones Beamer](https://www.overleaf.com/read/dnrwnjrpjjhw) y [pósteres](https://www.overleaf.com/read/jtbgmmgqrqmh): ¡hoy vamos a ver posibilidades de estilo aún más divertidas y emocionantes! ### Uso de markdown en plantillas de LaTeX con estilo Aparte de los ejemplos anteriores, puede usar markdown en casi todas las plantillas. Aquí tiene unos cuantos ejemplos rápidos: * El [Libro naranja de Legrange](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) plantilla * El [folleto inspirado en Tufte](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) plantilla * Este [plantilla de artículo muy bonita](https://www.overleaf.com/read/xfsrpsmdtqvt) de Thiago Puede que note que dos de estas son plantillas de artículo y una es una plantilla de libro. El [`paquete markdown`](http://www.ctan.org/pkg/markdown) detecta si el `\chapter` comando está disponible para su uso en un documento LaTeX concreto y hará que el encabezado de primer nivel `markdown` se renderice en línea `\chapter` o `\section` según corresponda. ### Folletos muy rápidos: markdown + pocketmod Desde la primera vez que aprendí sobre markdown me pareció una forma rápida y cómoda de tomar notas: refleja cómo podría estar garabateando notas en trozos de papel o notas adhesivas—especialmente con la sintaxis de listas con viñetas y numeradas. Cuando creé por primera vez la [Plantilla PocketMod](https://www.overleaf.com/read/nqbhpnrkskrx) en 2015, anhelaba una forma de escribir markdown en LaTeX para poder crear PocketMods *con* markdown porque me parecía… apropiado. Anotar notas en una sintaxis simple en pequeños folletos plegados, pero con buena tipografía—algunas personas se refieren a los PocketMods como «zines» porque son pequeños folletos de 8 páginas que se pueden hacer a partir de una sola hoja de papel A4. ¡Y así, en efecto, fue posible! Esto hace que sea bastante fácil producir rápidamente un [mini folleto planificador semanal](https://www.overleaf.com/read/zfzcxygqwqsq) o un pequeño [libro de cuentos ilustrado](https://www.overleaf.com/read/rppnsfgnrhsf). Sí, a mi hija le divirtió ver un libro de cuentos hecho con sus propios dibujos… bueno, ¡durante 10 minutos! El [`paquete markdown`](http://www.ctan.org/pkg/markdown) le permite personalizar cómo se renderiza cada sintaxis markdown a LaTeX, así que redefiní la sintaxis estándar `![](img_file "pie de foto")` sintaxis para colocar el pie de foto debajo del archivo de imagen (sin ningún prefijo «Figure» ni numeración), y luego inserté un salto de página. Esto hace que sea aún más fácil hacer el libro de imágenes. Aquí hay un video que muestra cómo plegar el folleto: {% embed url="" %} ### Folletos de recetas sencillas Cuando lo piensas, una receta se compone de listas: una lista de ingredientes, una lista de instrucciones de preparación o cocción y quizá una lista de notas (tiempo de cocción, raciones, etc.). Así que, en lugar de escribir esto: ```latex \begin{enumerate} \item Primero haz esto \item Luego haz eso ... \end{enumerate} ``` Sin duda agradecería poder escribir esto: ``` #. Primero haz esto #. Luego haz eso ``` Y del mismo modo para los ingredientes: ``` - 2 huevos - pizca de sal ``` Así que, para producir fácilmente una receta rápida, podemos escribir esto: ``` # Huevos revueltos Tiempo de cocción : 5 minutos Rinde : 1 ## Ingredientes - 4 huevos - 1 cucharadita de mantequilla - 1/4 taza de leche - sal, pimienta (al gusto) ## Instrucciones #. Bata los huevos, la leche... #. Caliente la mantequilla en una sartén... #. ... ``` Hmm, eso parece prometedor. Algunos de nosotros en Overleaf (y nuestras familias) contribuimos con nuestras recetas rápidas favoritas (ideales para cocineros principiantes) y yo improvisé (perdón por el juego de palabras) una [plantilla de receta rápida](https://www.overleaf.com/read/gscqdhnwzsfg) que puedes escribir con markdown *y* para convertirla en un mini folleto. [![A recipe booklet produced on Overleaf using markdown](/files/44f0efe06ae7f264c33fab5dbba1e7515c005c8f)](https://www.overleaf.com/read/gscqdhnwzsfg) Ahora viene otra parte divertida. Bajo el capó esto sigue siendo LaTeX, así que podemos seguir estilizando los diversos elementos—títulos de secciones, listas con viñetas, fuentes y demás—usando el habitual arsenal de trucos de LaTeX. Fue entonces cuando me dejé llevar un poco y se me ocurrieron *tres* «temas» para la clase `simple-recipe` ! ### Bonificación 1: algunas advertencias al usar el paquete markdown * SyncTeX no funcionará del todo. En Overleaf, esto significa que las operaciones «posición en la vista previa» y «hacer clic en la vista previa para saltar al origen» no funcionarán en las `markdown` regiones. * `\\` pierde su significado normal: el habitual truco de «dos espacios seguidos de una nueva línea» `markdown` no funciona aquí porque los espacios finales serán eliminados por el analizador de Lua, como se documenta en el [`markdown` documentación del paquete](http://texdoc.net/pkg/markdown). `\newline` sí funcionará, sin embargo. * Tenga cuidado con varios caracteres de guion bajo en la misma línea: esto puede ser un problema si: * está trabajando con muchos subíndices en sus ecuaciones (consejo: salga del entorno `markdown` en tales casos); * le gusta usar guiones bajos en sus claves BibTeX. Puede establecer `underscores=false` con los últimos archivos `paquete markdown` para que funcionen los guiones bajos como subíndices, pero aun así no funcionará con guiones bajos en las claves BibTeX. **Actualización** (13 de mayo de 2017): Los guiones bajos en las claves BibTeX funcionarán con `markdown` a partir de v2.5.2—¡gracias Vít! * Tendrá algunas dificultades para mostrar un carácter almohadilla literal porque ni siquiera `\#` funcionará. Normalmente defino un nuevo comando y uso eso en su lugar. ### Bonificación 2: nuevas funciones en el paquete markdown actualizado `markdown` v2.4 y posteriores añadieron compatibilidad con una sintaxis realmente agradable: * **Sintaxis de nota al pie en línea**: `...^[esta es la nota al pie]` (requiere la opción `inlineFootnotes` ) * **Citas:**`[@smith1990]` (requiere la opción `opción de citas` ; además, ¡cuidado con los guiones bajos en sus claves BibTeX!) * **Código delimitado**: Puede usar tildes `~` o comillas invertidas `` ` `` como delimitadores. ``` ~~~~ int main() { cout << "¡Hola, mundo!"; return 0; } ~~~~ ``` Si desea usar estas nuevas funciones, asegúrese de subir versiones actualizadas de `markdown.lua`, `markdown.tex` y `markdown.sty` a su proyecto—o puede simplemente crear un nuevo proyecto a partir de [esta plantilla](https://www.overleaf.com/read/whdrnpcpnwrm). --- # 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/32-markdown-into-latex-with-style.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.