Configurar estilos de cita CSL de Pandoc en el navegador: APA, Chicago, Vancouver
Pandoc puede convertir un documento lleno de claves de cita sueltas en un trabajo terminado con citas en el texto formateadas y una bibliografía. La maquinaria es citeproc, ahora integrado en el propio pandoc, y los estilos que sigue están escritos en CSL, el Citation Style Language. Ambos se comportan igual tanto si pandoc se ejecuta en la línea de comandos como si se compila a WebAssembly dentro de una pestaña del navegador.
Esta guía cubre qué es CSL y de dónde sacar los archivos de estilo, cómo preparar una bibliografía BibTeX en la que citeproc pueda confiar, qué cambia realmente entre la salida en APA, Chicago y Vancouver para la misma entrada, y qué errores dejan claves de cita literales en el texto final.
Qué es CSL
CSL significa Citation Style Language, un formato XML que describe con exactitud cómo debe verse una cita y una entrada bibliográfica: dónde va el año, si los títulos van en cursiva, cómo se comprimen los rangos de páginas. Todos los estilos importantes existen como archivo CSL, y solo el Zotero Style Repository alberga miles de ellos, desde APA y Chicago hasta los estilos propios de revistas concretas.
Como el estilo vive en un archivo y no en el código, cambiar de convención significa cambiar el archivo, no editar el documento. Las revistas que exigen un formato concreto suelen indicarlo por nombre, y el archivo CSL correspondiente se puede descargar del repositorio sin configuración alguna por tu parte.
Cómo resuelve citeproc una cita
En el documento fuente, las citas se escriben en línea con el signo de arroba. Una clave entre corchetes se convierte en una cita parentética, mientras que una clave usada directamente en la frase se convierte en una cita narrativa en la que el nombre del autor forma parte del texto. Los localizadores viajan con la clave, así que las referencias a páginas y capítulos van dentro de los corchetes.
Al convertir, citeproc lee cada clave, la busca en el archivo bibliográfico y entrega la entrada resuelta al estilo CSL para darle formato. La misma pasada recoge todas las entradas citadas y añade una lista de referencias al final del documento, o donde un bloque con el id refs marque el lugar. Las claves son etiquetas que eliges tú y nunca aparecen en la salida a menos que algo haya fallado.
Conseguir el archivo de estilo
El Zotero Style Repository permite buscar por editorial o palabra clave y descargar un archivo .csl con un clic. Lee bien los nombres de los estilos: Chicago existe como variante note-bibliography, que genera notas al pie, y como variante author-date, que genera citas parentéticas, y son dos archivos distintos.
Cuando una revista publica instrucciones de formato en lugar de un archivo, busca primero el nombre de la revista en el repositorio. Este sigue miles de revistas, y un archivo mantenido supera a uno editado a mano. Si no aparece nada, el estilo padre más cercano suele ser aceptable para borradores.
Preparar el archivo .bib
El archivo bibliográfico asocia claves con metadatos. En formato BibTeX cada entrada empieza con un tipo como article, book o inproceedings, seguido de una clave que inventas tú, y después campos como author, title, year, journal y DOI. La clave es lo que tecleas en el texto, así que corta y memorable gana a larga y precisa, y un esquema estable de autor, año y una palabra mantiene los borradores legibles años después.
La completitud de los campos se refleja directamente en la salida. Un año ausente deja un hueco en una cita APA, y un DOI ausente elimina el enlace que los lectores seguirían. Envolver los nombres propios en dobles llaves dentro del campo title protege sus mayúsculas, porque BibTeX podría pasar los títulos a minúsculas para cumplir las reglas del estilo.
Una entrada, tres salidas
Toma una sola línea con una clave entre corchetes y una clave narrativa. Bajo APA, un estilo author-date, la cita entre corchetes se convierte en nombre y año entre paréntesis, la narrativa en el autor seguido del año entre paréntesis, y la bibliografía se ordena alfabéticamente con sangría francesa. Bajo Chicago note-bibliography, las mismas citas se convierten en notas al pie numeradas, completas en la primera mención y abreviadas después.
Bajo Vancouver, habitual en medicina, las citas se convierten en números secuenciales entre corchetes ordenados por primera aparición y no alfabéticamente. En las tres variantes nada cambia en tu texto: las claves, el archivo y el documento se mantienen idénticos mientras solo se intercambia el archivo CSL, que es precisamente la idea del formato y la razón para configurarlo pronto.
Ejecutar las citas en el navegador
En este sitio, las opciones de citas Pro aceptan dos subidas: un archivo .bib con las referencias y un archivo .csl con el estilo elegido. Todo se ejecuta dentro del worker del navegador, donde citeproc forma parte del mismo motor Pandoc que realiza la conversión, así que las claves se resuelven exactamente como en la línea de comandos.
El flujo es corto: escribe el documento con claves de arroba como siempre, mantén un archivo .bib por proyecto, coloca el archivo de estilo que exige la revista de destino y convierte. Cambiar de revista más adelante significa subir un archivo .csl distinto, no reescribir ninguna cita.
Errores frecuentes y soluciones
El fallo más frecuente es una clave que no coincide: el texto cita una clave que el archivo .bib no define, y pandoc deja el texto en crudo entre corchetes en la salida mientras registra una advertencia sobre la referencia que falta. Revisa la ortografía de la clave y confirma que realmente subiste el archivo previsto.
Los problemas de mayúsculas vienen del campo title, donde los acrónimos y nombres propios llegan en minúsculas cuando el estilo lo exige; la protección con dobles llaves en el archivo .bib existe para evitarlo. Los campos que faltan aparecen como huecos o citas incompletas, así que una comprobación rápida de una entrada bibliográfica ya renderizada detecta la mayoría de los problemas antes de enviar el trabajo.
Salida del navegador frente a la línea de comandos
Como la versión de navegador ejecuta la misma implementación de citeproc dentro del mismo motor Pandoc, las citas formateadas y la bibliografía salen idénticas a lo que produciría la línea de comandos con las mismas entradas y versiones. No hay ningún formateador simplificado en medio.
Esa equivalencia convierte al navegador en un lugar legítimo para preparar un borrador de envío: aplica el estilo, comprueba las referencias renderizadas y entrega a los revisores un documento cuyas citas ya coinciden con la revista de destino. El conversor de este sitio mantiene el manejo de .bib y .csl dentro de tu navegador, así que los manuscritos inéditos también se quedan en tu equipo.