MDViewer

Primeros pasos

2026-07-27 527 palabras 3 min de lectura

Tres formas de abrir Markdown local, un recorrido por la interfaz y los tipos de archivo admitidos.

Iniciación

MDViewer renderiza Markdown en dos lugares: el lector en el navegador, que abre los archivos directamente desde tu propio equipo, y esta documentación. Ambos usan el mismo motor de renderizado y el mismo tema, así que lo que ves aquí es exactamente cómo se verán tus archivos.

Abrir archivos locales

Vuelve a la página de inicio del lector y usa cualquiera de estas opciones:

Método Cómo Cuándo conviene
Abrir carpeta Pulsa «Abrir carpeta» o la tecla O Leer una biblioteca entera, con búsqueda y enlaces entre archivos
Abrir un archivo Pulsa «Abrir un archivo» o Mayús+O Leer un solo documento
Arrastrar y soltar Suelta una carpeta o un archivo .md en cualquier punto de la página La vía más rápida

Nota

Tus archivos no se suben a ningún servidor. La lectura y el renderizado ocurren enteramente dentro del navegador, y todo se libera al cerrar la pestaña.

Compatibilidad de navegadores

Abrir una carpeta depende de la File System Access API :

  • Chrome / Edge / Opera 86+: compatibilidad completa, incluido el recuerdo de la última carpeta abierta
  • Safari / Firefox: recurren a <input webkitdirectory> y al arrastrar y soltar. Se puede leer sin problema, pero el navegador no recuerda la carpeta: hay que elegirla cada vez.

Recuperación de la sesión

Cuando abres una carpeta en un navegador compatible, el identificador del directorio se guarda en IndexedDB. La próxima vez que entres:

  • Si el permiso sigue vigente, vuelves automáticamente al archivo y a la posición donde lo dejaste
  • Si ha caducado, aparece un aviso de «seguir leyendo» en una esquina; con un clic se vuelve a conceder el acceso

La lista «Abiertos recientemente» de la página de inicio conserva tus últimos 8 espacios de trabajo.

La interfaz

  • Árbol de archivos a la izquierda: se despliega por niveles de directorio; el campo superior filtra por nombre de archivo; B lo pliega
  • Contenido en el centro: el ancho, el tamaño de letra, el interlineado y la tipografía se ajustan en los ajustes; , los abre
  • Esquema a la derecha: se genera con los encabezados de nivel 2 a 4 y resalta la sección actual al desplazarte; T lo pliega

Tipos de archivo admitidos

Al analizar un directorio, el lector recoge:

  • Documentos: .md .markdown .mdown .mkd .mdx .txt
  • Imágenes: .png .jpg .gif .svg .webp .avif .bmp .ico (para que las rutas relativas del Markdown funcionen)

Omite .git, node_modules, dist, build, .obsidian y directorios similares, además de todos los archivos ocultos que empiezan por .. Cada análisis cubre como máximo 6000 archivos y 12 niveles de profundidad.

Rutas relativas

Las imágenes y los enlaces escritos así funcionan sin más:

1
2
3
4
5

![Arquitectura](./images/arch.png)
![Imagen un nivel arriba](../assets/logo.svg)

[Ir a otra página](./advanced/config.md)
[Índice de la sección](../guide/)

Las imágenes se localizan dentro del espacio de trabajo y se convierten en URL blob locales; los enlaces a .md navegan dentro del lector sin recargar la página. Los destinos que no se encuentran se marcan en rojo con una explicación.

Siguientes pasos