commit 973de2f3955dce42de4157a48120c6e267a07f4e Author: Gerardo Marx Date: Wed Jun 18 21:21:06 2025 -0600 Example ready diff --git a/ieee.csl b/ieee.csl new file mode 100644 index 0000000..2089efb --- /dev/null +++ b/ieee.csl @@ -0,0 +1,400 @@ + + diff --git a/protocolo.md b/protocolo.md new file mode 100644 index 0000000..b2df7fc --- /dev/null +++ b/protocolo.md @@ -0,0 +1,126 @@ +--- +title: "Protocolo de Investigación: Uso de Markdown para la Redacción Científica" +author: Gerardo Marx Chávez-Campos +bibliography: referencias.bib +csl: ieee.csl +header-includes: + - \usepackage{graphicx} + - \usepackage{booktabs} + - \usepackage{amsmath} +output: pdf +--- + +## Introducción + +La redacción científica es una competencia fundamental para investigadores y estudiantes de posgrado [@lopez2021tesis] . En la era digital, el uso de lenguajes de marcado como Markdown ha cobrado relevancia por su simplicidad [@garcia2023markdown], compatibilidad y capacidad de conversión a múltiples formatos mediante herramientas como Pandoc [@witting2019],[@pandoc_manual]. + + +## Antecedentes + +Diversos autores han explorado metodologías para facilitar la escritura académica con tecnologías abiertas. Por ejemplo, Nobis et al. (2022) discuten el uso de Markdown y Pandoc como herramientas efectivas para la producción científica reproducible [@nobis2022markdown]. Además, herramientas como Zettlr y Obsidian han sido adoptadas en contextos educativos para gestionar bibliografía y redactar textos con apoyo de BibTeX [@knuth1984texbook]. + +## Objetivo General + +Explorar y ejemplificar el uso de Markdown y Pandoc como herramientas para la redacción estructurada de protocolos y artículos de investigación científica. + +## Objetivos Específicos + +- Redactar un protocolo completo en formato Markdown. +- Integrar referencias bibliográficas con BibTeX. +- Usar Pandoc para convertir el archivo a PDF, DOCX y otros formatos. +- Emplear plantillas de Word para estandarizar la salida. + +## Metodología + +### Herramientas + +- Markdown (.md) como formato base. +- BibTeX (.bib) para gestión bibliográfica. +- Pandoc para conversión de formatos. +- Plantilla de Word para formato estándar de salida. + +### Estructura del archivo Markdown + +El archivo incluirá metadatos (YAML) al inicio del archivo `md` que debe tener una estructura similar a la siguiente: + +```yaml +--- +title: "Protocolo de Investigación" +author: "Tu Nombre" +date: \today +fontsize: 12pt +geometry: margin=2.5cm +documentclass: article +header-includes: +  - \usepackage{graphicx} +  - \usepackage{amsmath} +  - \usepackage{hyperref} +  - \usepackage{float} +  - \usepackage{booktabs} +  - \usepackage[spanish]{babel} +  - \usepackage[utf8]{inputenc} +  - \usepackage[T1]{fontenc} +  - \usepackage{lipsum} +--- +``` + +Después de los metadatos, el contenido del archivo está estructurado en función de la convocatoria, formato de publicación o plantilla. Las citas bibliográficas se realizarán siguiendo la siguiente sintaxis `[@clave]`. Estas claves de cita son definidas en un archivo complementario, que en el caso de este repositorio es llamado `referencias.bib`. + +### Archivos bibtex + +El contenido del archivo `referencias.bib` sigue el formato tipo Bibtex y a continuación se indican las estructuras de las entradas más comunes como: artículos, libros, capítulos de libro, tesis, congresos, recursos en la web. + +**Artículo de revista** +```bibtex +@article{apellido2024ejemplo, + author = {Apellido, Nombre}, + title = {Título del artículo}, + journal = {Nombre de la Revista}, + year = {2024}, + volume = {12}, + number = {3}, + pages = {123--134}, + doi = {10.1234/ejemplo.doi} +} +``` + +**Libro** +```bibtex +@book{autor2022libro, + author = {Apellido, Nombre}, + title = {Título del Libro}, + publisher = {Editorial Ejemplo}, + year = {2022}, + edition = {2}, + address = {Ciudad} +} +``` + +### Estilos de citas CSL + +https://github.com/citation-style-language/styles-distribution/blob/master/ieee.csl?utm_source=chatgpt.com + + +### Ejemplos de comandos Pandoc + +```bash +# Convertir a PDF usando cita bibliográfica y plantilla de CSL +pandoc protocolo.md --citeproc -o protocolo.pdf + +# Convertir a DOCX con plantilla personalizada +pandoc protocolo.md --citeproc --reference-doc=plantilla.docx -o protocolo.docx + +# Convertir a HTML +pandoc protocolo.md --citeproc -o protocolo.html +``` + +### Flujo de trabajo + +1. Crear archivo `protocolo.md`. +2. Crear archivo `referencias.bib`. +3. Ejecutar comandos Pandoc desde terminal. +4. Validar formato de salida. + +## Referencias + +Las referencias se encuentran almacenadas en el archivo `referencias.bib` y se integran automáticamente mediante Pandoc. diff --git a/referencias.bib b/referencias.bib new file mode 100644 index 0000000..52711a3 --- /dev/null +++ b/referencias.bib @@ -0,0 +1,50 @@ +@article{witting2019, + title={The thermoelectric properties of bismuth telluride}, + author={Witting, Ian T and Chasapis, Thomas C and Ricci, Francesco and Peters, Matthew and Heinz, Nicholas A and Hautier, Geoffroy and Snyder, G Jeffrey}, + journal={Advanced Electronic Materials}, + volume={5}, + number={6}, + pages={1800904}, + year={2019}, + publisher={Wiley Online Library} +} + +@article{nobis2022markdown, + title={Scientific Writing with Markdown and Pandoc}, + author={Nobis, Thomas and Meurer, Philipp}, + journal={SoftwareX}, + volume={17}, + pages={100931}, + year={2022}, + publisher={Elsevier} +} + +@book{knuth1984texbook, + title={The TeXbook}, + author={Knuth, Donald E}, + year={1984}, + publisher={Addison-Wesley} +} + +@misc{pandoc_manual, + title = {Pandoc User’s Guide}, + author = {MacFarlane, John}, + year = {2024}, + note = {\url{https://pandoc.org/MANUAL.html}} +} + +@inproceedings{garcia2023markdown, + title={Implementación de Markdown en cursos de redacción académica}, + author={García, Luis and Pérez, Ana}, + booktitle={Congreso Nacional de Docencia 2023}, + pages={45--50}, + year={2023}, + organization={ANUIES} +} + +@phdthesis{lopez2021tesis, + title={Integración de herramientas de texto plano en procesos editoriales académicos}, + author={López, María}, + school={UNAM}, + year={2021} +}