MD Cuaderno - Tu gestor de notas con MD en VS Code

Cuaderno es una extensión para VS Code que te permite crear, organizar y gestionar tus notas en formato Markdown directamente desde el editor. Ideal para desarrolladores que quieren mantener su documentación, apuntes y conocimiento al alcance mientras programan.

Características principales

Cuaderno ofrece las siguientes funcionalidades:

• Explorador de cuadernos: Accede rápidamente a todas tus notas desde la barra de actividades, organizadas por categorías y etiquetas personalizables.
• Búsqueda integrada: Encuentra fácilmente cualquier cuaderno o componente con búsqueda instantánea que incluye contenido, títulos y etiquetas.
• Componentes MD: Biblioteca de componentes Markdown reutilizables para agilizar la creación de notas. Inserta bloques preformateados con un solo clic.
• Vista previa: Visualiza tus notas con formato directamente en VS Code, incluyendo soporte para diagramas y sintaxis especial.
• Creación rápida: Crea nuevos cuadernos con un solo clic desde la interfaz y organízalos automáticamente.
• Sincronización: Tus notas se guardan como archivos Markdown estándar, compatibles con otras herramientas y fáciles de sincronizar con servicios en la nube.

Organización intuitiva

La extensión organiza tus notas en dos secciones principales:

• Mis Cuadernos: Accede a todos tus documentos organizados por categorías. Puedes crear, editar y eliminar categorías para mantener tus notas perfectamente estructuradas.
• Componentes MD: Bloques predefinidos de código Markdown que puedes insertar en tus notas. Incluye plantillas para tablas, diagramas, bloques de código, y más.

Guía completa de uso

Primeros pasos

1. Haz clic en el icono de cuaderno en la barra de actividades de VS Code.
2. Utiliza el botón "+" para crear un nuevo cuaderno:
   • Puedes seleccionar una plantilla predeterminada
   • Asignar una categoría
   • Establecer etiquetas para facilitar su búsqueda posterior
3. Busca en tus cuadernos existentes o en los componentes con el icono de lupa:
   • Filtra por título, contenido o etiquetas
   • Accede rápidamente a los resultados con navegación por teclado
4. Visualiza tus notas con el botón de vista previa para ver el resultado formateado.

Trabajando con componentes

Los componentes MD son bloques de código reutilizables que ahorran tiempo al crear notas:

1. Navega a la sección "Componentes MD" en el explorador
2. Selecciona el componente que deseas utilizar
3. Haz clic para insertarlo en la posición actual del cursor
4. Personaliza el componente según tus necesidades

Los componentes incluyen:

• Tablas con diferentes formatos
• Diagramas (flowcharts, sequence, gantt)
• Bloques de código con resaltado de sintaxis
• Callouts y bloques de advertencia
• Plantillas para notas de reuniones y documentación

Organización avanzada

Para mantener tus notas perfectamente organizadas:

• Categorías: Crea jerarquías de categorías (con subcategorías) haciendo clic derecho en "Mis Cuadernos"
• Etiquetas: Añade etiquetas a tus notas para una clasificación transversal
• Favoritos: Marca tus notas más importantes como favoritas para acceso rápido
• Ordenación: Cambia el orden de visualización por fecha, nombre o uso reciente

Atajos de teclado

Para maximizar tu productividad:

• Ctrl+Shift+N: Crea un nuevo cuaderno
• Ctrl+Shift+F: Buscar en cuadernos
• Ctrl+Shift+V: Alternar vista previa
• Ctrl+Shift+C: Insertar componente rápido
• Alt+L: Aplicar formato de lista
• Alt+T: Insertar tabla rápida

Personalización

Cuaderno puede personalizarse a través de la configuración de VS Code:

• Ubicación de almacenamiento: Configura la carpeta donde se guardarán tus cuadernos
• Plantillas: Define plantillas personalizadas para nuevos cuadernos
• Aspecto visual: Personaliza colores y estilos de la vista previa
• Componentes personalizados: Crea tus propios componentes MD para reutilizarlos

Para acceder a la configuración:

1. Abre Configuración en VS Code (Ctrl+,)
2. Busca "MD Cuaderno"
3. Ajusta las opciones según tus preferencias

Requisitos

Esta extensión viene empaquetada con las siguientes extensiones para mejorar la experiencia Markdown:

• Markdown Preview Github Styling (bierner.markdown-preview-github-styles) - Para estilizar la vista previa como GitHub
• Markdown Mermaid (bierner.markdown-mermaid) - Para visualizar diagramas Mermaid
• Markdown Emoji (bierner.markdown-emoji) - Soporte para emojis en formato :smile:
• Markdown Checkboxes (bierner.markdown-checkboxes) - Visualización interactiva de listas de verificación
• Markdown YAML Preamble (bierner.markdown-yaml-preamble) - Soporte para metadatos en formato YAML
• Markdown Footnotes (bierner.markdown-footnotes) - Soporte para notas al pie de página
• Markdown All in One (yzhang.markdown-all-in-one) - Para funcionalidades avanzadas de edición Markdown

Estas extensiones se instalarán automáticamente con Cuaderno para brindarte una experiencia completa de edición y visualización de Markdown.

Preguntas frecuentes

¿Dónde se guardan mis notas?
Por defecto, tus notas se guardan en la carpeta del espacio de trabajo actual, dentro de una carpeta llamada "notas". Puedes cambiar esta ubicación en la configuración.

¿Puedo sincronizar mis notas entre dispositivos?
Sí, al estar basadas en archivos Markdown estándar, puedes usar cualquier servicio de sincronización como GitHub, OneDrive o Dropbox.

¿Puedo usar otros formatos además de Markdown?
La extensión está optimizada para Markdown, pero puedes incluir HTML dentro de tus archivos MD para funcionalidades adicionales.

¿Cómo puedo contribuir o reportar problemas?
Visita nuestro repositorio en GitHub para reportar issues o contribuir con mejoras.

Soporte

Si encuentras problemas o tienes sugerencias, por favor abre un issue en nuestro repositorio o contacta al equipo de soporte a través del correo support@mdcuaderno.com.