Claro, aquí tienes una guía completa para que los estudiantes que nunca han trabajado con R, RStudio/Posit Cloud y RPubs puedan empezar a crear y publicar sus propios documentos web.

🌐 Guía de Inicio: R Markdown en Posit Cloud y Publicación en RPubs

Esta guía te llevará paso a paso en el proceso de crear un documento dinámico usando R Markdown en la nube con Posit Cloud y cómo publicar tu trabajo como una página web en RPubs.

Definiciones Clave

Antes de empezar, es importante entender las herramientas que vamos a utilizar:

  • R: Es un lenguaje de programación y un entorno de software gratuito enfocado en el cálculo estadístico y la creación de gráficos. Es una de las herramientas más potentes y populares en el mundo de la ciencia de datos. 📊

  • Posit Cloud (anteriormente RStudio Cloud): Es una versión en la nube de RStudio. Imagina que puedes usar R y RStudio desde cualquier navegador web sin necesidad de instalar nada en tu computadora. Esto facilita el trabajo colaborativo y te permite acceder a tus proyectos desde cualquier lugar.

  • RPubs: Es un servicio web gratuito proporcionado por Posit que facilita la publicación de documentos creados con R Markdown. Con solo un clic, puedes compartir tus análisis, informes o tutoriales como una página web pública.

Paso 1: Creando tu Cuenta en Posit Cloud

Lo primero que necesitas es una cuenta en Posit Cloud para poder empezar a trabajar.

  1. Regístrate: Ve al sitio web de Posit Cloud y haz clic en el botón para registrarte. Puedes usar tu correo electrónico o una cuenta de Google/GitHub para hacerlo más rápido.
  2. Plan Gratuito: Elige el plan gratuito (Free Plan). Es más que suficiente para los cursos y proyectos de iniciación, ya que te ofrece una buena cantidad de horas de uso al mes.

Paso 2: Creando tu Primer Proyecto

Una vez dentro de Posit Cloud, verás tu espacio de trabajo personal (Your Workspace). Aquí es donde vivirán todos tus proyectos.

  1. Nuevo Proyecto: Haz clic en el botón azul que dice “New Project”.
  2. Desde Cero: Selecciona la opción “New RStudio Project”. Esto creará un nuevo entorno de trabajo limpio con la última versión de R y RStudio lista para usar.
  3. Espera un Momento: La plataforma tardará unos segundos en preparar tu proyecto. Una vez listo, verás la interfaz familiar de RStudio directamente en tu navegador.

Paso 3: Creando un Documento R Markdown

Ahora que tienes tu proyecto listo, es hora de crear tu primer documento R Markdown.

  1. Nuevo Archivo: En el menú superior de RStudio, ve a File > New File > R Markdown....
  2. Configuración Inicial:
    • Te aparecerá una ventana. Dale un título a tu documento (por ejemplo, “Mi Primer Reporte”).
    • Escribe tu nombre en el campo de autor (Author).
    • Asegúrate de que la salida por defecto sea HTML (esto es lo que necesitamos para crear una página web).
    • Haz clic en OK.
  3. Plantilla por Defecto: RStudio abrirá un nuevo archivo con la extensión .Rmd. Este archivo contiene un texto de ejemplo que te muestra cómo funciona R Markdown. ¡Es una excelente manera de empezar!

Paso 4: Entendiendo el Documento .Rmd

Un archivo R Markdown es un documento de texto plano que combina tres elementos clave:

  • El Encabezado YAML: Es el bloque de texto que está al principio del documento, entre dos líneas de ---. Aquí defines el título, autor, fecha y el tipo de archivo de salida (en nuestro caso, html_document).

    ---
title: "Mi Primer Reporte"
author: "Tu Nombre"
date: "9/9/2025"
output: html_document
---

  • Texto en Markdown: Todo el texto que no está en un bloque de código se escribe usando la sintaxis de Markdown. Es una forma muy sencilla de dar formato al texto. Por ejemplo:

    • # Título Principal
    • ## Subtítulo
    • **texto en negrita**
    • *texto en cursiva*
    • - Un elemento de una lista

  • Bloques de Código (Chunks): Aquí es donde escribes y ejecutas tu código de R. Se identifican porque empiezan con {r}` y terminan con. Todo lo que escribas dentro se interpretará como código de R.

    
``` r
summary(cars) # Esto es un ejemplo de código de R
```

```
##      speed           dist       
##  Min.   : 4.0   Min.   :  2.00  
##  1st Qu.:12.0   1st Qu.: 26.00  
##  Median :15.0   Median : 36.00  
##  Mean   :15.4   Mean   : 42.98  
##  3rd Qu.:19.0   3rd Qu.: 56.00  
##  Max.   :25.0   Max.   :120.00
```

Paso 5: “Tejiendo” tu Documento (Knit)

“Tejer” (o knit en inglés) es el proceso de convertir tu archivo .Rmd en el formato de salida final, en este caso, una página web HTML.

  1. Guarda el Archivo: Antes de nada, guarda tu documento. Ve a File > Save y dale un nombre (por ejemplo, mi_reporte.Rmd).
  2. Haz Clic en “Knit”: Busca el botón Knit en la parte superior del editor de texto (tiene un icono de una bola de lana y una aguja). Haz clic en él.
  3. ¡Magia!: R Markdown ejecutará todo el código de R que haya en tus chunks, tomará los resultados (tablas, gráficos, etc.), los incrustará en el documento y generará un archivo HTML que se abrirá automáticamente en una nueva ventana dentro de RStudio.

[Image showing the “Knit” button in the RStudio interface]

Paso 6: Publicando tu Página Web en RPubs

Ahora que tienes tu documento HTML, el último paso es compartirlo con el mundo a través de RPubs.

  1. Botón de Publicación: En la ventana donde se muestra tu documento HTML recién creado, busca un botón de “Publish” en la esquina superior derecha (suele tener un icono de un cuadrado con una flecha hacia arriba).
  2. Selecciona RPubs: Haz clic en él y selecciona la opción “Publish to RPubs”.
  3. Conecta tu Cuenta: La primera vez que lo hagas, RStudio te pedirá que autorices la conexión con tu cuenta de RPubs. Sigue las instrucciones para iniciar sesión o crear una nueva cuenta en RPubs (puedes usar la misma cuenta de Posit Cloud).
  4. Dale un Nombre y Publica:
    • RStudio te pedirá que le des un título y un nombre a la URL de tu publicación.
    • Asegúrate de que la opción seleccionada sea “Publish document with its source code” si quieres que otros puedan ver tu código .Rmd (esto es opcional).
    • Haz clic en “Publish”.
  5. ¡Felicidades!: Tu navegador se abrirá con una nueva pestaña mostrando tu documento publicado en una URL pública de RPubs, ¡listo para ser compartido!

¡Y eso es todo! Has pasado de no tener nada a crear un proyecto en la nube, escribir un documento dinámico con código y texto, y publicarlo como una página web. A medida que te familiarices con R Markdown, descubrirás que puedes crear reportes, presentaciones y hasta libros enteros con esta poderosa herramienta.