---
id: "arquivos-markdown"
titulo: "Markdown: modos, formato y notas"
resumo: "Crear un Markdown nuevo, alternar entre fuente, rico y vista previa, usar la edición rica y anotar un documento para revisión."
idioma: "es"
tipo: "guia"
categoria: "arquivos-git"
aplicavelDesde: "0.0.16"
capabilities: ["editor.markdown.views", "editor.markdown.richFormatting", "editor.newMarkdown.untitled", "editor.untitledRename", "review.markdown.notes"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/es/ferramentas/arquivos/markdown/"
fonte: "pt-br/ferramentas/arquivos/markdown.md"
caminhoPublico: "docs/publica/es/ferramentas/arquivos/markdown.md"
hashFonte: "sha256:eb4a2c85a0ab78a4c9c5e4e8de0dbcd1716168075254804e11c6d571175d0e36"
hashDestaPagina: "sha256:0bdc192362f387795858e63bb9cbab127b3127d3d84d8c789854733b33439601"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/ferramentas/arquivos/markdown.md fonteHash=sha256:eb4a2c85a0ab78a4c9c5e4e8de0dbcd1716168075254804e11c6d571175d0e36 estado=atual -->

## Crear un Markdown nuevo

Dos caminos:

- **Barra de pestañas → pestaña nueva → Markdown**
- **Comandos rápidos → nuevo archivo Markdown**

Los dos abren un **selector de plantilla**: elige una plantilla y el archivo nace a partir de ella.

Cómo funciona esto por dentro — y qué necesitas saber:

- **El archivo se escribe en el disco ya en la creación**, y se renombra después. Existe antes de que escribas cualquier cosa.
- **Cerrar sin editar quita el placeholder**: si lo creaste y no escribiste nada, el archivo no queda atrás.
- Una plantilla **con contenido real** cambia ese comportamiento: en ese caso el archivo no se elimina al cerrar sin ediciones.

## Guardar o renombrar un archivo nuevo

El diálogo de guardado pide **nombre y carpeta**:

- El nombre **no puede estar vacío** ni contener barras.
- **La carpeta debe estar dentro del workspace.**
- Los errores de validación aparecen en el propio diálogo, no como aviso suelto.
- La carpeta puede elegirse en el selector del sistema.

## Los tres modos de Markdown

| Modo | Qué hace |
|---|---|
| **Fuente** | Muestra el texto Markdown tal como es |
| **Rico** | Edición con formato aplicado |
| **Vista previa** | Renderiza el resultado, sin editar |

- **Vista previa al lado** abre el render en un panel aparte, manteniendo el texto a la vista.
- **Índice (tabla de contenidos)** está disponible en los modos **rico** y **vista previa** — no en el modo fuente.
- **Mostrar/ocultar front matter** alterna la visualización del encabezado del documento.
- **Exportar como PDF** genera un PDF del documento. La exportación queda **no disponible cuando no hay contenido renderizado** que exportar — es decir, en el modo fuente no hay qué exportar.

> **El modo "Cambios" es mutuamente excluyente con los modos de Markdown en tiempo de render.** Elegir Cambios sale del modo Markdown; volver a Markdown sale de Cambios.

## Edición rica

En el modo rico, el documento se edita con formato aplicado, y la superficie ofrece:

- **Barra de formato** — negrita, cursiva, títulos, listas, tabla, imagen y enlace.
- **Menú de comandos** — comandos disparados desde la barra.
- **Menú de emoji**.
- **Globo de enlace** — editar, abrir o quitar el enlace bajo el cursor.
- **Menú de enlace a documento interno** — apunta a otro documento en lugar de una URL externa.
- **Barra de búsqueda en el documento**.

> **La misma barra de formato aparece en la nota del Canvas.** Allí pertenece al dominio del Canvas; esta página cubre su uso dentro del editor de archivos.

## Notas de revisión

Las notas de revisión son anotaciones **ancladas a fragmentos de texto** del documento — un comentario pegado a la frase, no al archivo.

- El **riel de notas** muestra y oculta las notas, con un botón de alternancia.
- Cada nota es una **tarjeta** que puede **copiarse, editarse y borrarse**.
- Las notas pueden **enviarse al agente** por un menú propio.
- Las notas exigen el **modo rico con anotaciones habilitadas**.

**Límite importante:** las notas están ancladas a fragmentos, y el posicionamiento depende del layout del documento. **Los cambios de texto pueden desplazar los anclajes** — si editas mucho después de anotar, revisa si cada nota sigue apuntando al fragmento correcto.

## Límites

- **Exportar como PDF** depende de que haya documento renderizado.
- **El índice** no existe en el modo fuente.
- **Las notas de revisión** exigen modo rico con anotaciones habilitadas y pueden desplazarse cuando el texto cambia.

## Relacionados

- [El editor](/docs/es/ferramentas/arquivos/editor/)