|
|
|
|
@ -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.
|
