Bloc de Notas 2

A modern, powerful, and intuitive note-taking application inspired by Notion

English | Español

---

English

Overview

Bloc de Notas 2 is a free, open-source note-taking application built for productivity and organization. Inspired by Notion's intuitive interface, it combines powerful features with local-first data storage, giving you complete control over your notes.

Key Highlights:

• 📝 Block-Based Editor - Notion-like editing experience with slash commands
• 🎨 Customizable Themes - Light, dark, and system modes with accent colors
• 🔍 Advanced Search - Full-text search with regex and replace capabilities
• 📁 Project Organization - Hierarchical structure with projects and sub-pages
• 🔄 Git Integration - Version control with commit, branch, push/pull support
• 🌐 Multilingual - Full support for Spanish and English
• 💾 Local-First - All data stored locally (no cloud dependency)
• 🚀 Cross-Platform - Windows, macOS, Linux, and PWA

Screenshots

Light Theme	Dark Theme

Editor with Blocks	Git Integration

Features

Editor & Content

• ✅ Rich Text Formatting - Bold, italic, underline, strikethrough, colors
• ✅ Block Types - Headings, lists, tasks, code blocks, tables, callouts, quotes
• ✅ Multimedia Support - Images, videos, audio, embeds
• ✅ Dynamic Variables - Create reusable variables (local and global)
• ✅ Slash Commands (/) - Quick access to all block types
• ✅ Markdown Support - Write with markdown syntax shortcuts
• ✅ Table of Contents - Auto-generated TOC from headings
• ✅ Code Highlighting - Syntax highlighting for 100+ languages
• ✅ Drag & Drop - Reorder blocks (optional, can be disabled)

Organization

• ✅ Projects & Pages - Hierarchical structure with nested sub-pages
• ✅ Breadcrumb Navigation - Easy navigation through page hierarchy
• ✅ Search & Replace - Find and replace with case-sensitive and regex options
• ✅ Tags & Metadata - Organize pages with custom properties
• ✅ Favorites - Pin important projects for quick access

Collaboration & Sync

• ✅ Git Version Control - Full Git integration (init, commit, branch, merge)
• ✅ Conflict Resolution - Visual merge conflict resolver
• ✅ Remote Sync - Push/pull from GitHub, GitLab, or any Git remote
• ✅ Stash Support - Temporarily save work in progress
• ✅ Branch Management - Create, switch, and merge branches

Export & Import

• ✅ Export to Markdown - Standard .md format
• ✅ Export to DOCX - Microsoft Word format
• ✅ Export to PDF - Print-ready documents
• ✅ Export to HTML - Standalone web pages
• ✅ Import from Markdown/DOCX - Migrate from other tools
• ✅ JSON Backup/Restore - Full project backups

Customization

• ✅ Themes - Light, dark, and system-adaptive modes
• ✅ Fonts - Sans-serif, serif, and monospace options
• ✅ Accent Colors - 10+ preset color schemes
• ✅ Editor Width - Narrow, medium, wide, or full-width
• ✅ Font Size - Adjustable from 12px to 24px
• ✅ Custom Shortcuts - Rebind any keyboard shortcut
• ✅ Auto-Save - Configurable auto-save interval

Advanced Features

• ✅ Focus Mode - Distraction-free writing (hides sidebar and UI)
• ✅ Command Palette - Quick actions with Ctrl+K
• ✅ Mobile Optimized - Responsive design with PWA support
• ✅ Touch Gestures - Swipe to open/close sidebar on mobile
• ✅ Offline Support - Works completely offline
• ✅ Auto-Backup - Scheduled backups (daily/weekly/monthly)

Comparison with Notion

Feature	Bloc de Notas 2	Notion
Local-first data	✅ Yes	❌ Cloud only
Offline support	✅ Full	⚠️ Limited
Git integration	✅ Built-in	❌ No
Open source	✅ MIT License	❌ Proprietary
Price	🆓 Free	💰 Freemium
Block editor	✅ Yes	✅ Yes
Databases	❌ Not yet	✅ Yes
Real-time collaboration	❌ Coming soon	✅ Yes
Desktop app	✅ Windows/Mac/Linux	✅ Windows/Mac
Mobile app	✅ PWA	✅ Native

System Requirements

Desktop (Electron)

• OS: Windows 10+, macOS 10.14+, Linux (Ubuntu 18.04+)
• RAM: 4 GB minimum, 8 GB recommended
• Disk: 500 MB for app + storage for notes
• Display: 1280x720 minimum

Web/PWA

• Browser: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
• Internet: Only for initial load (then works offline)

Installation

Windows

1. Download BlocNotas2-Setup-x.x.x.exe from Releases
2. Run the installer
3. Launch from Start Menu or desktop shortcut

macOS

1. Download BlocNotas2-x.x.x.dmg
2. Open DMG and drag to Applications folder
3. Right-click > Open (first time only, due to Gatekeeper)

Linux

AppImage (universal):

chmod +x BlocNotas2-x.x.x.AppImage
./BlocNotas2-x.x.x.AppImage

Debian/Ubuntu:

sudo dpkg -i BlocNotas2-x.x.x.deb
sudo apt-get install -f
blocnotas2

Fedora/RHEL:

sudo rpm -i BlocNotas2-x.x.x.rpm
blocnotas2

Web/PWA

Visit https://blocnotas2.com and click "Install" in your browser.

Development Setup

Prerequisites:

• Node.js 18+ and npm 9+
• Git

Clone and install:

git clone https://github.com/Tech-Code1/blocnotas2.git
cd blocnotas2
npm install

Run in development:

# Web app (Vite dev server)
npm run dev

# Electron app
npm run dev:electron

Build for production:

# Web build
npm run build

# Electron build (creates installers)
npm run build:electron

Available Scripts

Script	Description
npm run dev	Start Vite dev server (port 5173)
npm run dev:electron	Start Electron app in development
npm run build	Build web app for production
npm run build:electron	Build and package Electron app
npm run lint	Run ESLint
npm run lint:fix	Run ESLint and auto-fix issues
npm run format	Format code with Prettier
npm run format:check	Check code formatting
npm run test	Run tests with Vitest
npm run test:ui	Run tests with Vitest UI
npm run test:coverage	Generate coverage report

Tech Stack

Frontend:

• React 19.2.3 with Hooks
• TypeScript 5+
• Zustand (state management)
• Tailwind CSS 4
• Radix UI (accessible components)
• Framer Motion (animations)

Desktop:

• Electron 27+
• Electron Builder (packaging)
• Electron Store (local persistence)

Editor:

• TipTap 3.14.0 (WYSIWYG editor, ProseMirror wrapper)
• Prism.js (syntax highlighting)

Utilities:

• react-i18next (internationalization)
• date-fns (date manipulation)
• fuse.js (fuzzy search)
• zod (schema validation)

Build & Dev:

• Vite 6+ (bundler)
• ESLint + Prettier
• Husky (git hooks)
• Vitest (testing)

Project Structure

BlocNotas2/
├── electron/                # Electron main process
│   ├── main.ts             # Main process entry
│   └── preload.ts          # Preload script (IPC bridge)
├── src/
│   ├── components/         # React components
│   │   ├── ui/            # Base UI components (buttons, dialogs, etc.)
│   │   ├── layout/        # Layout components (sidebar, navbar)
│   │   ├── editor/        # Editor components (toolbar, slash menu)
│   │   ├── pages/         # Page editor
│   │   ├── projects/      # Project management
│   │   ├── git/           # Git integration
│   │   ├── settings/      # Settings modal
│   │   └── workspace/     # Workspace setup
│   ├── contexts/          # React contexts
│   ├── extensions/        # TipTap custom extensions
│   ├── hooks/             # Custom React hooks
│   ├── i18n/              # Internationalization
│   │   ├── config.ts      # i18n configuration
│   │   └── locales/       # Translation files (es.json, en.json)
│   ├── lib/               # Utilities and helpers
│   ├── store/             # Zustand stores
│   ├── styles/            # Global CSS
│   ├── types/             # TypeScript type definitions
│   └── utils/             # Utility functions
├── docs/                   # Documentation
│   ├── USER_GUIDE.md      # User guide (Spanish)
│   └── USER_GUIDE_EN.md   # User guide (English)
├── .husky/                # Git hooks
└── dist-electron/         # Electron build output

Documentation

Document	Description
Getting Started	First steps for new contributors
Architecture	Technical architecture guide
Development Setup	Environment setup
Code Style	Coding conventions
Testing	How to write and run tests
API Reference	Internal API documentation
Contributing	How to contribute
Changelog	Version history
Code of Conduct	Community guidelines
Security Policy	Report vulnerabilities

Roadmap

Version 2.1 (Q1 2025)

• Real-time collaboration (WebRTC)
• Database views (table, kanban, calendar)
• Mobile native apps (iOS/Android)
• Plugin system for extensions

Version 2.2 (Q2 2025)

• End-to-end encryption
• Cloud sync (optional)
• Advanced templates
• AI-powered writing assistant

Version 3.0 (Q3 2025)

• API for third-party integrations
• Team workspaces
• Advanced permissions
• Self-hosted server option

Contributing

Contributions are welcome! Please read CONTRIBUTING.md first.

Quick start:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

Development workflow:

• Code style is enforced with ESLint and Prettier (runs on pre-commit via Husky)
• All PRs must pass CI checks (linting, tests)
• Write tests for new features
• Update documentation as needed

Support

• Bug reports: GitHub Issues
• Feature requests: GitHub Discussions
• Email: support@blocnotas2.com
• Community: Discord Server

License

This project is licensed under the MIT License - see LICENSE file for details.

Acknowledgments

• Inspired by Notion, Obsidian, and Evernote
• Built with TipTap editor framework
• Icons from Lucide
• UI components from Radix UI

Author

Tech-Code1

• GitHub: @Tech-Code1
• Twitter: @TechCode1

---

Español

Descripción General

Bloc de Notas 2 es una aplicación gratuita y de código abierto para tomar notas, diseñada para productividad y organización. Inspirada en la interfaz intuitiva de Notion, combina funciones poderosas con almacenamiento de datos local, dándote control total sobre tus notas.

Aspectos Clave:

• 📝 Editor Basado en Bloques - Experiencia de edición similar a Notion con comandos slash
• 🎨 Temas Personalizables - Modos claro, oscuro y del sistema con colores de acento
• 🔍 Búsqueda Avanzada - Búsqueda de texto completo con regex y capacidades de reemplazo
• 📁 Organización de Proyectos - Estructura jerárquica con proyectos y sub-páginas
• 🔄 Integración con Git - Control de versiones con soporte para commit, branch, push/pull
• 🌐 Multilingüe - Soporte completo para español e inglés
• 💾 Local-First - Todos los datos almacenados localmente (sin dependencia de la nube)
• 🚀 Multiplataforma - Windows, macOS, Linux y PWA

Características

Editor y Contenido

• ✅ Formato de Texto Enriquecido - Negrita, cursiva, subrayado, tachado, colores
• ✅ Tipos de Bloques - Títulos, listas, tareas, bloques de código, tablas, callouts, citas
• ✅ Soporte Multimedia - Imágenes, videos, audio, embeds
• ✅ Variables Dinámicas - Crea variables reutilizables (locales y globales)
• ✅ Comandos Slash (/) - Acceso rápido a todos los tipos de bloques
• ✅ Soporte Markdown - Escribe con atajos de sintaxis markdown
• ✅ Tabla de Contenidos - TOC auto-generado desde encabezados
• ✅ Resaltado de Código - Sintaxis para más de 100 lenguajes
• ✅ Drag & Drop - Reordena bloques (opcional, se puede deshabilitar)

Organización

• ✅ Proyectos y Páginas - Estructura jerárquica con sub-páginas anidadas
• ✅ Navegación Breadcrumb - Navegación fácil por la jerarquía de páginas
• ✅ Buscar y Reemplazar - Buscar y reemplazar con opciones sensibles a mayúsculas y regex
• ✅ Etiquetas y Metadatos - Organiza páginas con propiedades personalizadas
• ✅ Favoritos - Ancla proyectos importantes para acceso rápido

Colaboración y Sincronización

• ✅ Control de Versiones Git - Integración completa de Git (init, commit, branch, merge)
• ✅ Resolución de Conflictos - Resolvedor visual de conflictos de fusión
• ✅ Sincronización Remota - Push/pull desde GitHub, GitLab o cualquier remoto Git
• ✅ Soporte Stash - Guarda temporalmente el trabajo en progreso
• ✅ Gestión de Ramas - Crea, cambia y fusiona ramas

Exportar e Importar

• ✅ Exportar a Markdown - Formato .md estándar
• ✅ Exportar a DOCX - Formato de Microsoft Word
• ✅ Exportar a PDF - Documentos listos para imprimir
• ✅ Exportar a HTML - Páginas web independientes
• ✅ Importar desde Markdown/DOCX - Migra desde otras herramientas
• ✅ Backup/Restauración JSON - Respaldos completos de proyectos

Personalización

• ✅ Temas - Modos claro, oscuro y adaptativo del sistema
• ✅ Fuentes - Opciones sans-serif, serif y monospace
• ✅ Colores de Acento - Más de 10 esquemas de color preestablecidos
• ✅ Ancho del Editor - Estrecho, medio, ancho o ancho completo
• ✅ Tamaño de Fuente - Ajustable de 12px a 24px
• ✅ Atajos Personalizados - Reasigna cualquier atajo de teclado
• ✅ Auto-Guardado - Intervalo de auto-guardado configurable

Características Avanzadas

• ✅ Modo Enfoque - Escritura sin distracciones (oculta sidebar e UI)
• ✅ Paleta de Comandos - Acciones rápidas con Ctrl+K
• ✅ Optimizado para Móvil - Diseño responsive con soporte PWA
• ✅ Gestos Táctiles - Desliza para abrir/cerrar sidebar en móvil
• ✅ Soporte Offline - Funciona completamente sin conexión
• ✅ Auto-Backup - Respaldos programados (diario/semanal/mensual)

Requisitos del Sistema

Desktop (Electron)

• SO: Windows 10+, macOS 10.14+, Linux (Ubuntu 18.04+)
• RAM: 4 GB mínimo, 8 GB recomendado
• Disco: 500 MB para la app + almacenamiento para notas
• Pantalla: 1280x720 mínimo

Web/PWA

• Navegador: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
• Internet: Solo para carga inicial (luego funciona offline)

Instalación

Windows

1. Descarga BlocNotas2-Setup-x.x.x.exe desde Releases
2. Ejecuta el instalador
3. Inicia desde el Menú Inicio o el acceso directo del escritorio

macOS

1. Descarga BlocNotas2-x.x.x.dmg
2. Abre el DMG y arrastra a la carpeta Aplicaciones
3. Clic derecho > Abrir (solo la primera vez, debido a Gatekeeper)

Linux

AppImage (universal):

chmod +x BlocNotas2-x.x.x.AppImage
./BlocNotas2-x.x.x.AppImage

Debian/Ubuntu:

sudo dpkg -i BlocNotas2-x.x.x.deb
sudo apt-get install -f
blocnotas2

Fedora/RHEL:

sudo rpm -i BlocNotas2-x.x.x.rpm
blocnotas2

Web/PWA

Visita https://blocnotas2.com y haz clic en "Instalar" en tu navegador.

Configuración para Desarrollo

Prerrequisitos:

• Node.js 18+ y npm 9+
• Git

Clonar e instalar:

git clone https://github.com/Tech-Code1/blocnotas2.git
cd blocnotas2
npm install

Ejecutar en desarrollo:

# Aplicación web (servidor dev Vite)
npm run dev

# Aplicación Electron
npm run dev:electron

Compilar para producción:

# Build web
npm run build

# Build Electron (crea instaladores)
npm run build:electron

Scripts Disponibles

Script	Descripción
npm run dev	Inicia servidor dev Vite (puerto 5173)
npm run dev:electron	Inicia app Electron en desarrollo
npm run build	Compila app web para producción
npm run build:electron	Compila y empaqueta app Electron
npm run lint	Ejecuta ESLint
npm run lint:fix	Ejecuta ESLint y corrige automáticamente
npm run format	Formatea código con Prettier
npm run format:check	Verifica formato del código
npm run test	Ejecuta tests con Vitest
npm run test:ui	Ejecuta tests con UI de Vitest
npm run test:coverage	Genera reporte de cobertura

Stack Tecnológico

Frontend:

• React 19.2.3 con Hooks
• TypeScript 5+
• Zustand (gestión de estado)
• Tailwind CSS 4
• Radix UI (componentes accesibles)
• Framer Motion (animaciones)

Desktop:

• Electron 27+
• Electron Builder (empaquetado)
• Electron Store (persistencia local)

Editor:

• TipTap 3.14.0 (editor WYSIWYG, wrapper de ProseMirror)
• Prism.js (resaltado de sintaxis)

Utilidades:

• react-i18next (internacionalización)
• date-fns (manipulación de fechas)
• fuse.js (búsqueda fuzzy)
• zod (validación de schemas)

Build y Dev:

• Vite 6+ (bundler)
• ESLint + Prettier
• Husky (git hooks)
• Vitest (testing)

Documentación

Documento	Descripción
Primeros Pasos	Primeros pasos para nuevos colaboradores
Arquitectura	Guía de arquitectura técnica
Configuración de Desarrollo	Configuración del entorno
Estilo de Código	Convenciones de código
Testing	Cómo escribir y ejecutar tests
Referencia de API	Documentación de API interna
Guía de Contribución	Cómo contribuir
Changelog	Historial de versiones
Código de Conducta	Directrices de la comunidad
Política de Seguridad	Reportar vulnerabilidades

Hoja de Ruta

Versión 2.1 (Q1 2025)

• Colaboración en tiempo real (WebRTC)
• Vistas de base de datos (tabla, kanban, calendario)
• Apps móviles nativas (iOS/Android)
• Sistema de plugins para extensiones

Versión 2.2 (Q2 2025)

• Cifrado de extremo a extremo
• Sincronización en la nube (opcional)
• Plantillas avanzadas
• Asistente de escritura con IA

Versión 3.0 (Q3 2025)

• API para integraciones de terceros
• Espacios de trabajo en equipo
• Permisos avanzados
• Opción de servidor auto-alojado

Contribuir

¡Las contribuciones son bienvenidas! Por favor lee CONTRIBUTING.md primero.

Inicio rápido:

1. Haz fork del repositorio
2. Crea una rama de característica: git checkout -b feature/caracteristica-increible
3. Haz commit de tus cambios: git commit -m 'Añadir característica increíble'
4. Haz push a la rama: git push origin feature/caracteristica-increible
5. Abre un Pull Request

Flujo de desarrollo:

• El estilo de código se aplica con ESLint y Prettier (se ejecuta en pre-commit vía Husky)
• Todos los PRs deben pasar las verificaciones de CI (linting, tests)
• Escribe tests para nuevas características
• Actualiza la documentación según sea necesario

Soporte

• Reportes de bugs: GitHub Issues
• Solicitudes de características: GitHub Discussions
• Email: support@blocnotas2.com
• Comunidad: Servidor Discord

Licencia

Este proyecto está licenciado bajo la Licencia MIT - ver el archivo LICENSE para más detalles.

Agradecimientos

• Inspirado por Notion, Obsidian y Evernote
• Construido con el framework de editor TipTap
• Iconos de Lucide
• Componentes UI de Radix UI

Autor

Tech-Code1

• GitHub: @Tech-Code1
• Twitter: @TechCode1

---

Made with ❤️ by Tech-Code1

⬆ Back to top