Cómo compartir un archivo Markdown con alguien que no usa Markdown
5 de septiembre de 2026 · 27 min de lectura
Tienes un archivo .md. Lo escribiste tú, o guardaste una respuesta que te dio un asistente de chat en Markdown; a partir de aquí no cambia nada. Alguien necesita leerlo: un cliente, un jefe, un abogado, el albañil que te está haciendo un presupuesto. No va a instalar un editor de Markdown, no va a clonar un repositorio, y no debería tener que hacerlo. Cada forma de poner el documento delante de esa persona falla en algún punto, y el truco está en saber dónde, antes de pulsar enviar.
Resumen rápido
Elige según qué le pase al archivo después de que llegue, no según qué sea más rápido para ti. Si el lector lo va a editar y devolvértelo, adjunta la fuente y dile qué es. Si necesita leerlo una vez, en el móvil, en una reunión, convierte el archivo en un HTML autocontenido y adjúntalo, o publícalo como un enlace de solo lectura — de cualquiera de las dos formas recibe un documento y no una fuente. Un enlace vale la pena solo si no le pide nada al lector: sin cuenta, sin instalación, sin script. Y un enlace solo es revocable de verdad si revocarlo mata la dirección misma, de inmediato, sin que el lector tenga que colaborar — algo que ningún adjunto puede lograr nunca, porque un adjunto es una copia.
Qué hace la máquina del lector con tu archivo
La friccion no es Markdown. Markdown es un archivo de texto con puntuación, y se diseñó para que esa puntuación siguiera siendo legible cuando nada la renderiza. La fricción está en que los sistemas operativos, los clientes de correo y los teléfonos hacen cada uno una suposición distinta sobre una extensión de archivo para la que no tienen ninguna aplicación, y cada una de esas suposiciones se equivoca de una forma que no puedes ver desde tu lado.
Hay tres preguntas distintas escondidas en «¿puedes leer esto?». La primera es si el archivo se abre siquiera. La segunda es si se abre como un documento o como código fuente. La tercera es si lo que se abre es la versión que querías que vieran, hoy y dentro de seis meses. Pegar el texto responde a la primera y falla en la segunda. Adjuntar la fuente puede fallar directamente en la primera. Un enlace a un repositorio responde a las dos primeras y falla en silencio en la tercera, porque la dirección apunta a una rama que se mueve.
La última pregunta importa más de lo que la gente espera. La mayoría de los fallos al compartir ocurren después del momento de enviar. El cliente lo reenvía. El jefe vuelve al enlace tres meses después. Legal pide la versión que estaba vigente el día once. Sea lo que elijas, tiene que sobrevivir a que lo lea alguien a quien no le mandaste nada, en un momento que no elegiste.
Comparativa rápida: la chuleta
| Opción | Mejor para | Capacidad clave | Precio |
|---|---|---|---|
| Pegar el texto en el mensaje | Una nota corta sin tablas ni imágenes | Funciona en cualquier cliente; nada que abrir | Gratis |
Adjuntar el archivo .md |
Un lector que lo va a editar y devolver | Sin pérdidas — exactamente los bytes que tienes | Gratis |
| Un Gist | Un fragmento o nota para alguien técnico | Renderiza GFM en una URL, conserva revisiones | Gratis, hace falta una cuenta de GitHub para crearlo |
| Un archivo en un repositorio | Un documento que vive junto al código | Se renderiza en su sitio, versionado con el proyecto | Gratis para repositorios públicos |
| Un enlace de almacenamiento en la nube | Un archivo que ya guardas en Drive, Dropbox u OneDrive | Un enlace, con acceso controlado por cuenta | Nivel gratis; planes de pago según almacenamiento |
| Un adjunto HTML autocontenido | Un documento terminado que debe abrirse sin conexión | Un archivo, estilos inline, no pide nada a la red | Gratis |
| Un enlace publicado de solo lectura | Alguien que lee una vez, en el móvil, sin cuenta | Una dirección sin instalación, y que se puede retirar | Gratis |
| Un PDF | Impresión, firma, un registro fijo | Cada lector ve páginas idénticas | Gratis desde el diálogo de impresión del navegador |
| Alojamiento estático o Pages | Un conjunto de documentos enlazados entre sí | Navegación, dominio propio, búsqueda | Gratis para repositorios públicos; hay que mantener un paso de build |
Las formas de compartir un archivo Markdown
Pegar el texto en el mensaje
La opción más rápida, y la que funciona en todas partes. Copia el archivo en el correo, en el chat o en el ticket, y el lector lo tiene sin abrir nada.
| A favor | En contra |
|---|---|
| Sin adjunto, sin enlace, sin instalar nada — ya está delante de la otra persona | La sintaxis llega como puntuación, no como formato |
| Se puede citar y buscar dentro de su propio cliente de correo | Las tablas, imágenes y código se pierden o se estropean |
| Nada que revocar, porque nada se alojó | Los documentos largos son ilegibles como un muro de texto |
| Funciona cuando un filtro de correo elimina los adjuntos | Cada cliente aplica sus propias reglas parciales de Markdown |
Precio: gratis.
Lo que le pasa de verdad al texto
- Los encabezados llegan como
## Alcance, porque ningún cliente de correo parsea los encabezados ATX - Slack no tiene sintaxis de encabezado ni de tabla, así que ambos llegan como caracteres literales, mientras que
*Alcance*sale en negrita — un solo asterisco es negrita ahí, no cursiva - Las tablas salen peor que nada: la fila de guiones que marca la alineación no significa nada para una herramienta que no la parsea, así que el lector recibe un párrafo de barras verticales
- Las imágenes son la línea cruda
, y las rutas relativas nunca iban a resolverse en el cliente de otra persona de todas formas - Algunos clientes autoformatean mientras pegas, lo que es peor que ninguno: la mitad del documento se renderiza y la mitad no, y no puedes saber cuál desde la carpeta de enviados
¿Para quién es? Para cualquiera que mande algo corto, definitivo y casi todo prosa — un párrafo de estado, una decisión, tres puntos. Cualquier cosa más larga que una pantalla, o con una tabla dentro, quiere una de las opciones de abajo.
Adjuntar el archivo .md
Honesto y sin pérdidas. El destinatario recibe exactamente los bytes que tienes, que es la única opción de esta página que le permite cambiar una palabra y devolvértelo.
| A favor | En contra |
|---|---|
| Byte por byte, así que va y vuelve por edición sin pérdidas | Nada en una máquina estándar tiene registrada la extensión .md |
| Pequeño, texto plano y comparable | En un móvil suele no abrirse en absoluto |
| Sin alojamiento, sin cuenta, sin ningún servicio de por medio | Quien lo abra está leyendo la fuente, no un documento |
| La opción correcta cuando el archivo es la entrega | No puedes retirarlo, nunca |
Precio: gratis.
Lo que pasa de verdad en la máquina del lector
- Un doble clic en Windows o macOS abre un editor de código, un diálogo de «elegir una aplicación», o nada — la extensión no tiene ningún manejador por defecto
- Los clientes de correo a menudo lo previsualizan en línea como texto plano, que es el mejor resultado posible y queda totalmente fuera de tu control
- Algunos filtros de correo tratan las extensiones desconocidas como sospechosas, así que el adjunto puede quedar en cuarentena sin que ninguno de los dos se entere
- Renombrarlo a
.txtarregla la apertura y pierde la asociación con Markdown, lo que importa si lo van a editar - Si lo abren, las imágenes y los enlaces relativos apuntan a archivos que no tienen, así que el documento queda con agujeros
Si el lector tiene ganas pero se queda atascado, abrir un archivo .md cubre lo que funciona en una máquina sin nada especial instalado. Decir qué es el archivo cuando lo mandas evita casi toda la confusión: «esto es un archivo de texto — ábrelo en el Bloc de notas o TextEdit, o simplemente léelo en la vista previa» es una sola frase.
¿Para quién es? Para cualquiera cuyo lector vaya a editar el documento, y para cualquiera cuyo lector sea suficientemente técnico como para que la fuente no sea un insulto. Es la opción equivocada para un cliente que pidió ver una propuesta.
Un Gist
Un Gist es un pequeño documento alojado con una URL. Renderiza GitHub Flavored Markdown, así que la dirección del Gist ya es una página legible, y conserva un historial de revisiones porque un Gist es, por debajo, un repositorio Git.
| A favor | En contra |
|---|---|
| Renderiza GFM correctamente — tablas, listas de tareas, código con vallas | El lector aterriza dentro de una interfaz de desarrollador |
| Una URL corta, sin instalar nada para el lector | Crear uno necesita una cuenta de GitHub, aunque leerlo no |
| Se conservan las revisiones, así que puedes señalar una versión concreta | Un Gist secreto no está listado, no es privado: cualquiera con la URL puede leerlo |
| Editable después, en el navegador | Borrarlo es la única forma de retirarlo, y es permanente |
Precio: gratis. Leerlo no necesita cuenta; crearlo necesita una cuenta de GitHub, que es gratis.
Lo que ve alguien que no es desarrollador
- Una página con tu documento en el centro y una barra de herramientas de Raw, Blame, History y un botón de fork alrededor
- Una caja de «clonar esto» que ofrece una dirección HTTPS y otra SSH, ninguna de las cuales significa nada para esa persona
- Campos de comentario debajo, que parecen una invitación a una conversación que quizá no quieras
- Tu avatar y usuario de GitHub como firma, que está bien para un README y resulta raro en un presupuesto de obra
- En un móvil, el marco de la interfaz se lleva una buena parte de la pantalla antes de que empiece el documento
¿Para quién es? Para alguien que manda un fragmento, un archivo de configuración, un reporte de error o una nota a otro desarrollador. Es una buena herramienta que se usa constantemente con el público equivocado: el renderizado es correcto y el entorno está mal para cualquiera que no viva ya en GitHub. Y «secreto» es la palabra que engaña a la gente: significa que la URL no está indexada ni listada, no que el acceso esté controlado.
Un archivo en un repositorio
Si el documento pertenece a un proyecto, ponlo junto al código. GitHub, GitLab y Bitbucket renderizan Markdown en la vista de archivo, así que la URL del archivo ya es una página.
| A favor | En contra |
|---|---|
| Versionado junto con el código que describe | Un repositorio privado le pide al lector que inicie sesión |
| Revisable — los cambios llegan por una pull request | Uno público muestra tu texto dentro de una interfaz pensada para desarrolladores |
| Renderiza GFM, tablas y listas de tareas incluidas | El enlace apunta a una rama, así que se mueve |
| Gratis, y ya forma parte del flujo de trabajo | El historial conserva cada versión anterior, incluida la que te arrepientes |
Precio: gratis para repositorios públicos; los repositorios privados están incluidos en los planes gratuitos de los tres, con límites y planes de pago descritos en sus propias páginas de precios.
Los detalles que deciden esto
- El enlace por defecto es
/blob/main/doc.md, que resuelve a lo que digamainhoy y no a lo que decía cuando mandaste el enlace - Pulsar
yen GitHub reescribe la dirección para fijar el commit, lo que arregla el blanco móvil pero no la interfaz alrededor - La vista Raw sirve el archivo como texto plano, así que es una descarga o un muro de fuente, no un documento
- Las rutas relativas de imágenes y enlaces sí se resuelven dentro de la vista del repositorio, que es justo por qué se rompen en cuanto el archivo se lee en otro sitio, tanto en un correo como en una página convertida
- Borrar el archivo lo elimina del árbol actual y no del historial, así que no es una retirada en ningún sentido que aceptaría un abogado
¿Para quién es? Para equipos. Este es el hogar correcto para documentación que vive en el repositorio, donde el público ya tiene cuenta y el historial de versiones es el objetivo. Es el hogar equivocado para un presupuesto que le mandaste a un cliente el martes pasado.
Un enlace de almacenamiento en la nube
Ya guardas archivos en Drive, Dropbox o OneDrive, y cada uno te va a dar un enlace para compartir cualquier cosa de la carpeta. Es el camino de menor resistencia, y lo que recibe el lector al otro lado es menos predecible que en las demás opciones de aquí.
| A favor | En contra |
|---|---|
| Ninguna herramienta nueva: el archivo ya está ahí | Lo que hace la vista previa con .md varía según el proveedor y cambia sin avisar |
| Control de acceso por cuenta, que es control de acceso real | «Cualquiera con el enlace» y «personas concretas» se confunden fácil y se pulsan mal fácil |
| Revocar el enlace funciona de verdad | Un muro de inicio de sesión delante de un documento que querías que leyera cualquiera |
| La caducidad y las contraseñas existen en algunos planes | A menudo el lector solo obtiene un botón de descarga |
Precio: nivel gratis con cualquier cuenta de consumidor. Los planes de pago se cobran por almacenamiento, y controles de enlace como la caducidad y las contraseñas están en niveles de pago con algunos proveedores — comprueba la página de precios del proveedor antes de prometerle a un cliente un enlace con caducidad.
Qué comprobar antes de mandar uno
- Abre el enlace en una ventana privada. Es la única forma de saber si tu lector se encuentra con un muro de inicio de sesión, porque tu propio navegador ya está autenticado
- Confirma si la vista previa renderiza el Markdown, muestra la fuente como texto plano, u ofrece una descarga — los tres comportamientos existen, y ninguno se anuncia
- Comprueba si el enlace permite editar. Lo predeterminado no siempre es de solo lectura, y la diferencia importa en un documento con un precio dentro
- Recuerda que el archivo sigue viviendo en tu carpeta. Renombrarlo o moverlo puede romper el enlace que ya mandaste
¿Para quién es? Para cualquiera que comparte con un grupo con nombre dentro de una organización que ya usa ese proveedor, donde iniciar sesión no es un obstáculo y las listas de acceso son el objetivo. Para un desconocido que va a leer una vez en el móvil, es más fricción de la que necesita el trabajo.
Un archivo HTML autocontenido como adjunto
Convierte el Markdown en un único archivo HTML con sus estilos inline, y adjunta eso. El lector hace doble clic y obtiene un documento terminado en el navegador que ya tiene, y lo que tiene que contener un archivo para comportarse así, cuánto cuesta en bytes incrustar y cómo demostrar que no descarga nada merece leerse antes de confiar en el formato.
| A favor | En contra |
|---|---|
| Se abre en cualquier máquina, sin instalación y sin cuenta | Sigue siendo un adjunto, así que los filtros de correo siguen aplicando |
| Funciona con la red apagada, en un tren, en un sótano | Más grande que la fuente, porque el estilo viaja con él |
| Se imprime y exporta a PDF con el propio diálogo del navegador | No puedes retirarlo — el lector tiene una copia |
| Nada está alojado, así que nada puede caerse ni ser revocado bajo sus pies | No es editable de una forma que vayan a disfrutar |
Precio: gratis.
Por qué «autocontenido» es la palabra que carga el peso
- Un documento completo implica doctype,
<head>y un bloque<style>inline — no un fragmento de etiquetas<h1>y<p>, que se renderiza como texto negro sin estilo a todo lo ancho de la ventana - Sin peticiones externas: sin hoja de estilos de CDN, sin fuente web, sin analítica. Un archivo que descarga su propio estilo se ve roto sin conexión y le cuenta a quien lo abra algo sobre por dónde ha pasado
- Las imágenes tienen que estar incrustadas y no enlazadas, o el documento llega con agujeros en una máquina que no tiene tu carpeta
- El HTML crudo es legal en Markdown, así que un archivo convertido puede llevar una etiqueta
<script>que llegó con la fuente. Si el Markdown no lo escribiste tú, sanitizar no es opcional antes de enviarle el resultado a otra persona - El archivo es el registro completo. Seis meses después se abre exactamente igual que el día que lo mandaste, que es la propiedad que ningún enlace tiene
¿Para quién es? Para cualquiera cuyo lector necesite un documento y no una página, y para cualquiera que quiera que el envío sea definitivo. Propuestas, notas de traspaso, actas de reunión, cualquier cosa que se vaya a archivar. También es la respuesta cuando la organización del destinatario bloquea dominios desconocidos y abre adjuntos sin problema.
Un enlace publicado de solo lectura
Renderiza el Markdown una vez, alójalo, y pasa la dirección. Nada que descargar, nada que instalar, y se lee como un documento en el móvil dentro de un ascensor.
| A favor | En contra |
|---|---|
| Fricción cero para el lector: tocar y leer | El documento depende de que un servicio esté funcionando |
| Puedes corregir una errata después de enviarlo | El lector no tiene copia, así que nada sobrevive a la revocación |
| Revocable, si el enlace está construido para eso | Reenviarlo es trivial e invisible para ti |
| Se renderiza bien en pantalla pequeña | El filtro de correo de una organización puede reescribir o bloquear la URL |
Precio: gratis.
Lo que tiene que hacer el mecanismo
- Servir el documento renderizado, no la fuente Markdown, y no un visor que necesite un plugin
- Llevar un token no adivinable en la dirección, y quedarse fuera de los índices de búsqueda
- Funcionar sin sesión, en la primera visita, en un móvil, en un portátil corporativo con una política de navegador agresiva
- Renderizar en el servidor o entregar el HTML ya terminado, para que un lector con los scripts bloqueados siga viendo el documento
- Dejarte matar la dirección por tu cuenta, sin pedirle nada al lector
TransformPipe cubre las dos formas de esto. Suelta el archivo .md en transformpipe.com y descarga un archivo autocontenido; o inicia sesión y publícalo como una página de solo lectura en /s/<token>. Revocar retira el token, así que un enlace que ya mandaste deja de funcionar. Desde un terminal es un solo comando:
node cli/tp.mjs login tp_live_… # una vez, con una clave de API
node cli/tp.mjs push proposal.md --share link
¿Para quién es? Para cualquiera que manda un documento a alguien que lo va a leer una vez y nunca lo va a archivar. También para cualquiera que espera revisarlo: la dirección se mantiene mientras el contenido mejora, que es lo único que un adjunto no puede hacer.
Un PDF
Convierte a HTML, ábrelo, imprime a PDF. Son dos pasos en vez de uno, y compra una propiedad que ninguna otra opción tiene: cada lector ve las mismas páginas en el mismo orden.
| A favor | En contra |
|---|---|
| Se abre en cualquier sitio, móviles incluidos | Ancho de página fijo, así que se lee mal en pantalla pequeña |
| Paginación, que importa para firma y citación | El reajuste desaparece: las tablas largas se cortan mal entre páginas |
| Aceptado por procesos que no van a aceptar un enlace | Editarlo es otra herramienta y una experiencia peor |
| Un registro fijo: la página 4 es la página 4 para todos | Más grande que el HTML del que viene |
Precio: gratis desde el propio diálogo de impresión del navegador, que incluye cualquier navegador moderno.
Detalles que conviene saber
- La hoja de estilos de impresión decide el resultado. Un documento que se ve bien en pantalla puede perder los bordes de los bloques de código y las reglas de las tablas en papel
- Los enlaces sobreviven como anotaciones clicables en la salida PDF de la mayoría de los navegadores, y los pies de página pueden añadir la URL de origen, lo que es útil o ruido según el documento
- Los encabezados suelen convertirse en marcadores de PDF solo si el conversor los emite a propósito; la vía de impresión del navegador, en general, no lo hace
- El texto sigue siendo seleccionable, así que el documento es buscable y citable — una captura de pantalla no es un sustituto
¿Para quién es? Para cualquiera que manda algo hacia un proceso: un contrato, una factura, una presentación, cualquier cosa que se vaya a firmar o archivar. No es la respuesta correcta para un documento que esperas revisar dos veces la semana que viene.
Alojamiento estático o Pages
GitHub Pages, GitLab Pages y cualquier generador de sitios estáticos convierten Markdown a HTML y lo ponen en la web con navegación y un dominio propio. Ninguno de ellos es una forma de compartir un solo archivo.
| A favor | En contra |
|---|---|
| Navegación, búsqueda y enlaces cruzados entre muchos documentos | Un archivo de configuración, un tema y un paso de build que mantener |
| Un dominio propio, que se lee como tuyo y no como de un proveedor | Público por defecto: el control de acceso necesita planes de pago o un proxy delante |
| Rápido, cacheado y gratis de servir | Publicar es un despliegue, así que arreglar una errata es un commit y una espera |
| Bien documentado y muy desplegado | Despublicar es otro despliegue, no un interruptor |
Precio: gratis para repositorios públicos en los principales proveedores; publicar desde un repositorio privado exige uno de sus planes de pago, descritos en sus propias páginas de precios.
¿Para quién es? Para cualquiera que publica un conjunto de documentos que se enlazan entre sí y espera que los encuentren. Si tienes un archivo y una persona a la que mandárselo, la sobrecarga es enorme y el modelo de acceso es el equivocado — un alojamiento estático publica para todo el mundo, y tú querías publicar para un lector.
Lo que un enlace para compartir debería pedirle al lector, y lo que no
La mayor parte de la decepción al compartir viene de enlaces que le piden algo al lector. Mandas una dirección esperando que aparezca un documento, y lo que aparece es un formulario. Desde tu lado se veía bien, porque tu navegador ya estaba con la sesión iniciada.
Un enlace de solo lectura debería:
- abrirse en cualquier navegador, sin cuenta, sin aplicación y sin extensión
- mostrar el documento renderizado, no la fuente Markdown
- leerse bien en un móvil, a un tamaño sensato, sin necesidad de hacer zoom
- funcionar con los scripts bloqueados, porque muchos navegadores corporativos los bloquean
- ser revocable solo por ti, en cualquier momento, sin la ayuda del lector
- llevar una dirección que no se pueda adivinar y que no esté indexada
No debería:
- poner un muro de inicio de sesión delante de un documento que querías que leyera cualquiera
- pedir una dirección de correo antes de mostrar nada
- exigir un navegador concreto, o una aplicación para una «mejor experiencia»
- traer fuentes, estilos o analítica de otros hosts, lo que le cuenta a terceros quién está leyendo qué
- romperse cuando el lector lo reenvía a un compañero, que es justo lo que va a hacer
Hay un caso intermedio que merece nombrarse. Cuando un documento es de verdad confidencial, una lista de destinatarios es el control correcto: solo los lectores nombrados pueden abrirlo, y tienen que iniciar sesión para demostrar quiénes son. Eso es un mecanismo distinto, no un enlace más estricto. Un enlace que cualquiera puede abrir sirve para una propuesta, una especificación o las actas de una reunión; una lista de destinatarios sirve para cualquier cosa que te disgustaría ver reenviada. Decidir cuál necesitas lleva diez segundos y evita el fallo donde un enlace «privado» resulta ser un enlace público que nadie ha encontrado todavía.
Lo que tiene que hacer revocar para merecer llamarse revocar
Todo servicio con un botón de compartir dice que el enlace se puede revocar. La mayoría dice algo más débil de lo que asumes. Revocar solo es revocar si se cumple todo lo siguiente.
Mata la dirección, no el listado. Quitar un documento de tu propia lista de elementos compartidos mientras la URL sigue resolviendo es limpieza, no revocación. Pruébalo abriendo la dirección en una ventana privada después de revocar; si el documento aparece, no ha pasado nada.
Hace efecto ahora. Una copia en caché servida durante otra hora es un documento todavía legible durante otra hora. Pregunta cuál es el tiempo de vida de la caché, y trata «con el tiempo» como una función distinta.
No necesita nada del lector. Cualquier mecanismo que dependa de que el destinatario borre un archivo, vacíe una carpeta o pulse «quitar acceso» no es revocación — es una petición.
No se puede desactivar por otra persona. Si un compañero con acceso a la misma carpeta puede volver a compartir el archivo, la dirección que mataste vuelve bajo otro nombre.
Dice qué no cubre. Revocar no puede recuperar una copia. Cualquier cosa descargada, impresa, capturada en pantalla, reenviada como adjunto o indexada en un buscador queda fuera de alcance para siempre. Un enlace revocado ayer todavía puede existir en un proxy de caché dentro de la empresa de alguien.
Ese último punto es el límite honesto de toda la idea. La revocación controla las lecturas futuras de quien conservó el enlace; no controla nada sobre quien conservó el documento. Si el requisito es «esto tiene que dejar de existir», ningún mecanismo para compartir de esta página lo entrega, y no deberías decirle a un cliente lo contrario.
Dónde falla la opción obvia y qué cuesta
La opción obvia, en cuanto sabes que un enlace es posible, es mandar siempre un enlace. Es un toque para el lector y se puede corregir después de enviarlo. Esto es lo que cuesta.
Un enlace es una dependencia. El documento es legible mientras un servicio esté en pie, un dominio esté renovado y una cuenta esté al día. Un adjunto no tiene ninguna condición así. Para cualquier cosa con vida larga — un contrato, una especificación que alguien vaya a citar dentro de dos años — la copia es el artefacto más seguro, y el enlace es la comodidad.
Un enlace convierte el documento en un blanco móvil. La capacidad de corregir una errata después de enviarlo es la misma capacidad de cambiar un número después de un acuerdo. Si el documento es un registro, eso es un defecto y no una función, y el arreglo es una versión fijada o un adjunto.
Un enlace falla dentro de la infraestructura de otros. Los sistemas de correo corporativos reescriben URLs para escanearlas, los clientes de chat las despliegan en vistas previas que no pediste, y algunos filtros simplemente rechazan dominios desconocidos. Nada de eso es visible desde el lado del envío. Los adjuntos tienen sus propios problemas de filtro, pero fallan de forma ruidosa.
Un enlace filtra la lectura. Cualquier documento alojado puede contarle a su propietario cuándo se abrió. Eso a veces es exactamente lo que quieres y a veces es algo que no te gustaría que te hicieran a ti. Si el servicio también carga fuentes o analítica de otro sitio, la visita del lector se revela a terceros que ninguno de los dos elegisteis.
Un enlace no es un documento para el lector. No lo puede archivar, anotar, ni encontrar en tres meses buscando en su correo. Bastantes lectores, dado un enlace, intentan de inmediato guardar la página como archivo — mal. Manda el archivo si eso es lo que van a hacer con él.
El fallo simétrico también merece nombrarse. Adjuntar siempre un archivo convertido significa que cada corrección es un correo nuevo, ningún lector está nunca seguro de cuál es la versión actual, y el documento se te va de las manos en cuanto llega. Los dos modos de fallo son simétricos, y por eso la respuesta está en mirar el documento y no en elegir un favorito.
Cómo elegir
- Parte de lo que pasa después de que llegue. Si lo van a editar, adjunta la fuente; cualquier otra cosa y estarán editando una vista renderizada, que van a hacer mal y a devolver. Si lo van a archivar, manda un archivo. Si lo van a leer una vez, manda un enlace.
- Cuenta lo que tiene que hacer el lector. Cada instalación, cuenta y diálogo entre la dirección y el documento pierde una fracción de tus lectores, y esa fracción es la más alta precisamente entre quienes no querían leerlo desde el principio. Cero pasos es alcanzable, así que trata un paso como un coste.
- Decide si el documento tiene permitido cambiar. Un enlace que se mantiene actualizado es correcto para un documento vivo y equivocado para un registro. Si alguien puede necesitar demostrar qué decía en una fecha determinada, manda un adjunto o fija una versión, porque «lo actualicé desde entonces» no es una respuesta.
- Comprueba si te disgustaría verlo reenviado. Si la respuesta es sí, una URL no adivinable no es el control que necesitas — una lista de destinatarios lo es. Decidir esto bien al principio es mucho más barato que descubrirlo con una captura de pantalla en el hilo de otra persona.
- Abre tu propio enlace compartido en una ventana privada antes de mandarlo. Esto atrapa el muro de inicio de sesión, la vista previa que solo descarga, la imagen que falta y el enlace relativo roto, todo en menos de un minuto, y es la única forma de ver lo que ve tu lector en vez de lo que muestra tu sesión autenticada.
Conclusión
Compartir un archivo Markdown no es un problema de conversión, es una pregunta sobre el lector. Cuando la respuesta es «quieren imprimirlo», las rutas de PDF están aquí. La pregunta: qué va a hacer su máquina con lo que le mandas, y qué va a hacer esa persona con ello después. Corto y definitivo, pégalo. Pensado para editarse, adjunta la fuente y di qué es. Parte de un proyecto, guárdalo junto al código. Pensado para leerse una vez por alguien que nunca ha oído hablar de Markdown, conviértelo en un archivo HTML autocontenido y adjúntalo, o publícalo como un enlace de solo lectura y sé honesto contigo mismo sobre lo que esa revocación puede y no puede deshacer. TransformPipe convierte Markdown en un documento HTML completo en el navegador, gratis, sin subir nada mientras no tengas la sesión iniciada — y luego, con el enlace o el archivo en la mano, ábrelo en una ventana privada y léelo como lo va a leer tu lector.
Preguntas frecuentes
¿Cómo comparto un archivo Markdown con alguien que no tiene un editor de Markdown?
No le mandes Markdown. Convierte el archivo en un HTML autocontenido y adjúntalo, o publícalo como un enlace de solo lectura — las dos opciones le dan un documento renderizado en el navegador que ya tiene. Manda la fuente .md solo cuando necesite editarla y devolvértela.
¿Puedo compartir un archivo .md como enlace sin crear una cuenta?
Puedes convertirlo sin cuenta, y alojarlo en general necesita una. La conversión en el navegador produce el archivo HTML sin ningún registro, y ese archivo se puede adjuntar a un correo de inmediato. Publicar una URL implica que algo tiene que alojarla, que es donde entra una cuenta — pero el lector sigue sin necesitar ninguna.
¿Es un Gist una buena forma de compartir un documento con alguien que no es desarrollador?
Renderiza el Markdown correctamente y lo rodea de una interfaz de desarrollador: Raw, Blame, History, una caja de clonado y campos de comentario. Para un compañero que usa GitHub todos los días eso es invisible; para un cliente resulta confuso. Recuerda también que un Gist secreto está sin listar y no es privado, así que cualquiera con la URL puede leerlo.
¿Es seguro mandarle a alguien un archivo HTML convertido?
Lo es, siempre que la conversión haya sanitizado la fuente. Markdown permite HTML crudo, así que un archivo .md que no escribiste tú puede llevar una etiqueta <script> o un manejador onerror directo hasta la página convertida. Para tus propias notas no importa; para un archivo que llegó de otro sitio, comprueba que el conversor sanitiza antes de reenviar el resultado.
¿Qué pasa de verdad cuando revoco un enlace para compartir?
Como mínimo, la dirección debería dejar de resolver de inmediato, para todos, sin que el lector tenga que hacer nada. No recupera copias: cualquier cosa descargada, impresa, capturada en pantalla o guardada en caché por un intermediario sigue siendo legible. La revocación controla las visitas futuras de quien conservó el enlace, y nada sobre quien conservó el documento.
¿Debería mandar un PDF en vez de un enlace?
Si el documento va hacia un proceso — firma, presentación, archivo — sí, porque un PDF es un registro fijo que todos ven igual. Si se va a leer una vez en el móvil y posiblemente se va a revisar la semana siguiente, no: las páginas fijas se leen mal en pantalla pequeña y cada revisión es un archivo nuevo.
¿Sobrevivirán mis tablas e imágenes al compartirlas?
Las tablas sobreviven si el renderizador hace GitHub Flavored Markdown, y no sobreviven al pegarse en un mensaje, donde la fila de alineación se convierte en una línea de guiones. Las imágenes sobreviven solo si están incrustadas en la salida o alojadas en una dirección absoluta, porque una ruta relativa apunta a una carpeta que el lector no tiene.