🌟 Why NotePages?

NotePages bridges the gap between structured Markdown note-taking and the fluid freedom of physical pen-and-paper. Designed from the ground up for students, researchers, visual thinkers, and professionals, it brings a rich, dedicated multi-page digital notebook workflow natively into your Obsidian Vault with 100% offline local privacy.

[!NOTE] All drawings, sticky notes, formulas, and pages are stored as clean JSON files inside your vault with the .gnote extension. Your data remains completely yours—no external cloud dependencies, no tracking, and no proprietary lock-in.

🚀 Quick Start in 60 Seconds

Step 1: Create a Notebook

• Click the Book Icon (NotePages: New notebook) in your Obsidian left Ribbon.
• Alternatively, press Ctrl/Cmd + P and search for NotePages: Create new notebook.
• You can also right-click any folder in the File Explorer and choose New notebook.

Step 2: Choose Your Paper Template

• Use the Top Toolbar to switch between Blank, Ruled (Lined), Grid, Dotted, or Cornell templates.
• Adjust line spacing and background colors to match your favorite stationery.

Step 3: Ink, Type, and Sketch

• Pick a pen tool (Ballpoint, Pressure Pen, Fountain Pen, or Highlighter).
• Draw shapes and hold for 350ms—they will snap automatically into clean geometry.
• Double-click anywhere to insert a rich Text Box, or click the Sticky Note icon for pastel notes.
• Type LaTeX formulas directly with $...$ or $$...$$.

Step 4: Export & Share

• Click the Export icon in the toolbar or open the Command Palette and type NotePages: Export notebook.
• Export individual pages or entire notebooks to print-ready PDF, high-resolution PNG (up to 300 DPI), or vector SVG.

🎨 Core Features

1. High-Precision Stylus & Inking Engine

• Hardware-Accelerated Strokes: Powered by perfect-freehand with 60–120 FPS render loops using requestAnimationFrame. Zero perceptible stroke latency.
• Natural Pen Tools:
  • Ballpoint Pen: Crisp, uniform lines ideal for fast writing and technical drawings.
  • Pressure-Sensitive Pen: Responds realistically to stylus pressure on Apple Pencil, Surface Pen, and Wacom styluses.
  • Fountain Pen: Dynamic velocity and calligraphic thinning for expressive handwriting.
  • Authentic Highlighter: Uses canvas multiply blend mode so bright highlights layer softly without washing out text or underlying handwriting.
• Accurate Dot Inking: Sensitive micro-tap detection ensures i-dots, periods, and commas register reliably.
• Dual Eraser Engine:
  • Stroke Eraser: Deletes entire intersecting strokes and geometric shapes with a single tap.
  • Precision Eraser: Trims and cuts strokes at the exact touch radius for precision corrections.

2. Smart Shapes & Connectors

• Hold-to-Snap Recognition: Scribble a line, circle, ellipse, rectangle, triangle, or arrow and pause for 350ms—NotePages snaps it into a mathematically perfect shape.
• Dedicated Shape Palette: Quickly drop predefined geometric shapes with custom stroke width, border colors, and optional solid fills.
• Smart Connectors: Draw linking arrows and lines between diagrams with live snap endpoints.
• Eraser Compatibility: The eraser tool deletes both freehand drawings and geometric shapes seamlessly.

3. Sticky Notes, Rich Text & LaTeX Math

• Pastel Sticky Notes: Color-coded notes with soft drop shadows, drag-to-resize bounds, and multi-line text editing.
• Rich Text Boxes: Floating text containers with adjustable font sizes, alignment, font families, and markdown styling.
• Native LaTeX Formulas: Write inline math $\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2}$ or display blocks $$E = mc^2$$ with automatic MathJax/KaTeX rendering.
• Obsidian Wikilinks: Type [[My Other Note]] inside any text box or sticky note. Click to navigate, or hover with Ctrl/Cmd for native Obsidian popover previews.

4. Continuous Multi-Page Workspace

• Seamless Vertical Scrolling: Pages flow smoothly from top to bottom just like an endless paper binder.
• Page Thumbnail Sidebar: An interactive side drawer displaying real-time miniature renderings of your strokes, sticky notes, texts, and images.
• Safe Page Management: Add, duplicate, reorder, or delete pages with full Undo / Redo (Ctrl+Z / Ctrl+Y) protection—never lose work from an accidental deletion.
• Smart Memory Virtualization: Large notebooks (50–100+ pages) cull off-screen canvases from memory, guaranteeing fast performance and minimal RAM usage.

5. Smooth Touchpad & Touch Gestures

• Cursor-Anchored Zooming: Smooth trackpad pinch-to-zoom keeps the exact point under your cursor fixed in place.
• Palm Rejection: Dedicated drawing engine ignores palm touches when using an active stylus. Toggle Draw with finger in Settings if you prefer finger sketching.

📑 PDF Import & Annotation

Turn any existing PDF into an annotated digital notebook:

1. Right-click any PDF in your Obsidian Vault file explorer and select Import PDF as notebook.
2. Or use the Command Palette: NotePages: Import PDF as new notebook.
3. NotePages renders each PDF page as an immutable, crisp background canvas.
4. Highlight passages, take margin notes, insert sticky notes, or draw diagrams on top of the original document.
5. Export back to vector PDF with all your annotations layered over the original pages.

⌨️ Shortcuts & Gestures

Drawing & Inking

Canvas Navigation

Selection & Editing

Page Management

⚙️ Settings & Customization

Access settings via Obsidian Settings → Community Plugins → NotePages:

📤 Multi-Format Export Engine

Export your work anytime without quality loss via Toolbar → Export icon or Ctrl/Cmd + P → NotePages: Export notebook:

┌────────────────────────────────────────────────────────┐
│                   NotePages Exporter                   │
├────────────────────────────────────────────────────────┤
│ Format:      [ PDF Document ]  [ PNG Images ]  [ SVG ] │
│ Resolution:  [ 1x (72 DPI)  ]  [ 2x (144) ]  [ 4x(300)]│
│ Range:       (•) All Pages     ( ) Current   ( ) Custom│
│ Destination: (•) Save to Vault ( ) Download to Disk    │
└────────────────────────────────────────────────────────┘

• Vector PDF: Preserves crisp strokes and embeds original PDF backgrounds.
• Ultra HD PNG: Export at 300 DPI (4x) for high-resolution printing or slide presentations.
• Vector SVG: Exports pure SVG code for editing in Illustrator, Inkscape, or Figma.

💬 Feedback & Community

Your feedback shapes the future of NotePages! We would love to hear your thoughts, feature requests, or bug reports:

• 📝 User Feedback & Feature Survey: Quick 1-minute feedback form directly reviewed by the developer.
• 💬 GitHub Discussions: Share your notes, discuss workflows, or ask questions.
• 🐛 GitHub Issue Tracker: Report bugs or technical issues with reproducible details.

❓ Frequently Asked Questions

🛠️ Development & Building

# Clone the repository
git clone https://github.com/0xKurian/Obsinotes.git
cd Obsinotes

# Install dependencies
npm install

# Run TypeScript type check
npm run typecheck

# Run linter
npm run lint

# Run automated test suite (178 unit & integration tests)
npm test

# Build production bundle
npm run build

📄 License

This project is licensed under the MIT License.
Created and maintained with ❤️ by Vinh-Hung.