From f5567a71b3fd2d34056752e5657e0c95f3fadd49 Mon Sep 17 00:00:00 2001
From: Gamosoft <gamosoft@users.noreply.github.com>
Date: Wed, 26 Nov 2025 11:28:09 +0100
Subject: [PATCH 1/9] added templating system

---
 backend/main.py           |  96 ++++++++++++++++++++++++++++++++++
 backend/utils.py          | 105 ++++++++++++++++++++++++++++++++++++++
 documentation/FEATURES.md |  44 ++++++++++++++++
 frontend/app.js           |  72 ++++++++++++++++++++++++++
 frontend/index.html       |  97 ++++++++++++++++++++++++++++++++++-
 5 files changed, 413 insertions(+), 1 deletion(-)

diff --git a/backend/main.py b/backend/main.py
index 8b2539e..37869f9 100644
--- a/backend/main.py
+++ b/backend/main.py
@@ -38,6 +38,9 @@ from .utils import (
     validate_path_security,
     get_all_tags,
     get_notes_by_tag,
+    get_templates,
+    get_template_content,
+    apply_template_placeholders,
 )
 from .plugins import PluginManager
 from .themes import get_available_themes, get_theme_css
@@ -777,6 +780,99 @@ async def get_notes_by_tag_endpoint(tag_name: str):
         raise HTTPException(status_code=500, detail=safe_error_message(e, "Failed to get notes by tag"))
 
 
+# --- Template Endpoints ---
+
+@api_router.get("/templates")
+async def list_templates():
+    """
+    List all available templates from _templates folder.
+    
+    Returns:
+        List of template metadata
+    """
+    try:
+        templates = get_templates(config['storage']['notes_dir'])
+        return {"templates": templates}
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=safe_error_message(e, "Failed to list templates"))
+
+
+@api_router.get("/templates/{template_name}")
+async def get_template(template_name: str):
+    """
+    Get content of a specific template.
+    
+    Args:
+        template_name: Name of the template (without .md extension)
+        
+    Returns:
+        Template name and content
+    """
+    try:
+        content = get_template_content(config['storage']['notes_dir'], template_name)
+        
+        if content is None:
+            raise HTTPException(status_code=404, detail="Template not found")
+        
+        return {
+            "name": template_name,
+            "content": content
+        }
+    except HTTPException:
+        raise
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=safe_error_message(e, "Failed to get template"))
+
+
+@api_router.post("/templates/create-note")
+@limiter.limit("60/minute")
+async def create_note_from_template(request: Request, data: dict):
+    """
+    Create a new note from a template with placeholder replacement.
+    
+    Args:
+        data: Dictionary containing templateName and notePath
+        
+    Returns:
+        Success status, path, and created content
+    """
+    try:
+        template_name = data.get('templateName', '')
+        note_path = data.get('notePath', '')
+        
+        if not template_name or not note_path:
+            raise HTTPException(status_code=400, detail="Template name and note path required")
+        
+        # Get template content
+        template_content = get_template_content(config['storage']['notes_dir'], template_name)
+        
+        if template_content is None:
+            raise HTTPException(status_code=404, detail="Template not found")
+        
+        # Apply placeholder replacements
+        final_content = apply_template_placeholders(template_content, note_path)
+        
+        # Save the note
+        success = save_note(config['storage']['notes_dir'], note_path, final_content)
+        
+        if not success:
+            raise HTTPException(status_code=500, detail="Failed to create note from template")
+        
+        # Run plugin hooks
+        plugin_manager.run_hook('on_note_create', note_path=note_path, initial_content=final_content)
+        
+        return {
+            "success": True,
+            "path": note_path,
+            "message": "Note created from template successfully",
+            "content": final_content
+        }
+    except HTTPException:
+        raise
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=safe_error_message(e, "Failed to create note from template"))
+
+
 # --- Notes Endpoints ---
 
 @api_router.get("/notes")
diff --git a/backend/utils.py b/backend/utils.py
index 8459805..cd69ff3 100644
--- a/backend/utils.py
+++ b/backend/utils.py
@@ -647,3 +647,108 @@ def get_notes_by_tag(notes_dir: str, tag: str) -> List[Dict]:
     
     return matching_notes
 
+
+# ============================================================================
+# Template Functions
+# ============================================================================
+
+def get_templates(notes_dir: str) -> List[Dict]:
+    """
+    Get all templates from the _templates folder.
+    
+    Args:
+        notes_dir: Base notes directory
+        
+    Returns:
+        List of template metadata (name, path, modified)
+    """
+    templates = []
+    templates_path = Path(notes_dir) / "_templates"
+    
+    if not templates_path.exists():
+        return templates
+    
+    try:
+        for template_file in templates_path.glob("*.md"):
+            try:
+                stat = template_file.stat()
+                templates.append({
+                    "name": template_file.stem,
+                    "path": str(template_file.relative_to(notes_dir).as_posix()),
+                    "modified": datetime.fromtimestamp(stat.st_mtime).isoformat()
+                })
+            except Exception as e:
+                print(f"Error reading template {template_file}: {e}")
+                continue
+    except Exception as e:
+        print(f"Error accessing templates directory: {e}")
+    
+    return sorted(templates, key=lambda x: x['name'])
+
+
+def get_template_content(notes_dir: str, template_name: str) -> Optional[str]:
+    """
+    Get the content of a specific template.
+    
+    Args:
+        notes_dir: Base notes directory
+        template_name: Name of the template (without .md extension)
+        
+    Returns:
+        Template content or None if not found
+    """
+    template_path = Path(notes_dir) / "_templates" / f"{template_name}.md"
+    
+    if not template_path.exists():
+        return None
+    
+    # Security check: ensure template is within notes directory
+    if not validate_path_security(notes_dir, template_path):
+        print(f"Security: Template path is outside notes directory: {template_path}")
+        return None
+    
+    try:
+        with open(template_path, 'r', encoding='utf-8') as f:
+            return f.read()
+    except Exception as e:
+        print(f"Error reading template {template_name}: {e}")
+        return None
+
+
+def apply_template_placeholders(content: str, note_path: str) -> str:
+    """
+    Replace template placeholders with actual values.
+    
+    Supported placeholders:
+        {{date}}      - Current date (YYYY-MM-DD)
+        {{time}}      - Current time (HH:MM:SS)
+        {{datetime}}  - Current datetime (YYYY-MM-DD HH:MM:SS)
+        {{timestamp}} - Unix timestamp
+        {{title}}     - Note name without extension
+        {{folder}}    - Parent folder name
+    
+    Args:
+        content: Template content with placeholders
+        note_path: Path of the note being created
+        
+    Returns:
+        Content with placeholders replaced
+    """
+    now = datetime.now()
+    note = Path(note_path)
+    
+    replacements = {
+        '{{date}}': now.strftime('%Y-%m-%d'),
+        '{{time}}': now.strftime('%H:%M:%S'),
+        '{{datetime}}': now.strftime('%Y-%m-%d %H:%M:%S'),
+        '{{timestamp}}': str(int(now.timestamp())),
+        '{{title}}': note.stem,
+        '{{folder}}': note.parent.name if str(note.parent) != '.' else 'Root',
+    }
+    
+    result = content
+    for placeholder, value in replacements.items():
+        result = result.replace(placeholder, value)
+    
+    return result
+
diff --git a/documentation/FEATURES.md b/documentation/FEATURES.md
index 7509ef7..8685a02 100644
--- a/documentation/FEATURES.md
+++ b/documentation/FEATURES.md
@@ -7,6 +7,7 @@
 - **Three view modes**: Edit, Split, Preview
 - **Auto-save** - Never lose your work
 - **Undo/Redo** - Ctrl+Z / Ctrl+Y support
+- **Note templates** - Create notes from templates with dynamic placeholders
 - **Syntax highlighting** for code blocks (50+ languages)
 - **Copy code blocks** - One-click copy button on hover
 - **LaTeX/Math rendering** - Beautiful mathematical equations with MathJax (see [MATHJAX.md](MATHJAX.md))
@@ -162,6 +163,49 @@ graph TD
 
 📄 **See the [MERMAID](MERMAID.md) note for diagram examples and syntax reference.**
 
+## 📄 Note Templates
+
+Create notes from reusable templates with dynamic placeholder replacement.
+
+### Creating Templates
+1. Create markdown files in `data/_templates/` folder
+2. Use placeholders for dynamic content
+3. Templates appear in the "New from Template" menu
+
+### Available Placeholders
+- `{{date}}` - Current date (YYYY-MM-DD)
+- `{{time}}` - Current time (HH:MM:SS)
+- `{{datetime}}` - Current date and time
+- `{{timestamp}}` - Unix timestamp
+- `{{title}}` - Note name (without extension)
+- `{{folder}}` - Parent folder name
+
+### Example Template
+```markdown
+---
+tags: [meeting]
+date: {{date}}
+---
+
+# {{title}}
+
+**Created:** {{datetime}}
+
+## Notes
+
+```
+
+### Using Templates
+1. Click the "New" dropdown button
+2. Select "New from Template"
+3. Choose a template and enter a note name
+4. The new note will be created with placeholders replaced
+
+### Built-in Templates
+- **meeting-notes** - Template for meeting notes
+- **daily-journal** - Daily journal with morning goals and evening reflection
+- **project-plan** - Project planning template with objectives and timeline
+
 ## ⚡ Keyboard Shortcuts
 
 ### General
diff --git a/frontend/app.js b/frontend/app.js
index 6e3bc15..49364ef 100644
--- a/frontend/app.js
+++ b/frontend/app.js
@@ -100,6 +100,12 @@ function noteApp() {
         // Dropdown state
         showNewDropdown: false,
         
+        // Template state
+        showTemplateModal: false,
+        availableTemplates: [],
+        selectedTemplate: '',
+        newTemplateNoteName: '',
+        
         // Homepage state
         selectedHomepageFolder: '',
         _homepageCache: {
@@ -258,6 +264,7 @@ function noteApp() {
             await this.loadThemes();
             await this.initTheme();
             await this.loadNotes();
+            await this.loadTemplates();
             await this.checkStatsPlugin();
             this.loadSidebarWidth();
             this.loadEditorWidth();
@@ -591,6 +598,71 @@ function noteApp() {
             this.applyFilters();
         },
         
+        // ========================================================================
+        // Template Methods
+        // ========================================================================
+        
+        // Load available templates from _templates folder
+        async loadTemplates() {
+            try {
+                const response = await fetch('/api/templates');
+                const data = await response.json();
+                this.availableTemplates = data.templates || [];
+            } catch (error) {
+                ErrorHandler.handle('load templates', error, false); // Don't show alert, templates are optional
+            }
+        },
+        
+        // Create a new note from a template
+        async createNoteFromTemplate() {
+            if (!this.selectedTemplate || !this.newTemplateNoteName.trim()) {
+                return;
+            }
+            
+            try {
+                // Determine the note path based on current context
+                let notePath = this.newTemplateNoteName.trim();
+                if (!notePath.endsWith('.md')) {
+                    notePath += '.md';
+                }
+                
+                // If we're in a folder on the homepage, create in that folder
+                if (this.selectedHomepageFolder) {
+                    notePath = `${this.selectedHomepageFolder}/${notePath}`;
+                }
+                
+                // Create note from template
+                const response = await fetch('/api/templates/create-note', {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        templateName: this.selectedTemplate,
+                        notePath: notePath
+                    })
+                });
+                
+                if (!response.ok) {
+                    const error = await response.json();
+                    alert(error.detail || 'Failed to create note from template');
+                    return;
+                }
+                
+                const data = await response.json();
+                
+                // Close modal and reset state
+                this.showTemplateModal = false;
+                this.selectedTemplate = '';
+                this.newTemplateNoteName = '';
+                
+                // Reload notes and open the new note
+                await this.loadNotes();
+                await this.loadNote(data.path);
+                
+            } catch (error) {
+                ErrorHandler.handle('create note from template', error);
+            }
+        },
+        
         // Clear all tag filters
         clearTagFilters() {
             this.selectedTags = [];
diff --git a/frontend/index.html b/frontend/index.html
index 0e890c5..319e40c 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -944,7 +944,17 @@
                         >
                             <span class="text-lg">📁</span>
                             <span>New Folder</span>
-                </button>
+                        </button>
+                        <button 
+                            @click.stop="showTemplateModal = true; showNewDropdown = false"
+                            class="w-full px-4 py-2.5 text-sm text-left flex items-center gap-3 transition-colors"
+                            style="color: var(--text-primary);"
+                            onmouseover="this.style.backgroundColor='var(--bg-hover)'"
+                            onmouseout="this.style.backgroundColor='transparent'"
+                        >
+                            <span class="text-lg">📄</span>
+                            <span>New from Template</span>
+                        </button>
                     </div>
                 </div>
             </div>
@@ -1618,6 +1628,91 @@
         </div>
     </div>
     
+    <!-- Template Selection Modal -->
+    <div x-show="showTemplateModal" 
+         @click.self="showTemplateModal = false; selectedTemplate = ''; newTemplateNoteName = ''"
+         class="fixed inset-0 flex items-center justify-center z-50"
+         style="background-color: rgba(0, 0, 0, 0.5);"
+         x-cloak>
+        <div class="rounded-lg shadow-xl p-6 max-w-md w-full mx-4"
+             style="background-color: var(--bg-secondary); color: var(--text-primary);"
+             @click.stop>
+            
+            <h2 class="text-xl font-bold mb-4" style="color: var(--text-primary);">Create from Template</h2>
+            
+            <!-- Template Selection -->
+            <div class="mb-4">
+                <label class="block text-sm font-medium mb-2" style="color: var(--text-secondary);">
+                    Select Template
+                </label>
+                <select 
+                    x-model="selectedTemplate"
+                    class="w-full px-3 py-2 rounded border"
+                    style="background-color: var(--bg-tertiary); color: var(--text-primary); border-color: var(--border-primary);"
+                >
+                    <option value="">-- Choose a template --</option>
+                    <template x-for="template in availableTemplates" :key="template.name">
+                        <option :value="template.name" x-text="template.name"></option>
+                    </template>
+                </select>
+            </div>
+            
+            <!-- Note Name Input -->
+            <div class="mb-4">
+                <label class="block text-sm font-medium mb-2" style="color: var(--text-secondary);">
+                    Note Name
+                </label>
+                <input 
+                    x-model="newTemplateNoteName"
+                    type="text"
+                    placeholder="Enter note name"
+                    class="w-full px-3 py-2 rounded border"
+                    style="background-color: var(--bg-tertiary); color: var(--text-primary); border-color: var(--border-primary);"
+                    @keydown.enter="createNoteFromTemplate()"
+                />
+            </div>
+            
+            <!-- Info about placeholders -->
+            <div class="mb-4 text-xs p-3 rounded" style="background-color: var(--bg-tertiary); color: var(--text-secondary);">
+                <strong>Available placeholders:</strong><br>
+                <code style="font-family: monospace;">{{date}}</code>, 
+                <code style="font-family: monospace;">{{time}}</code>, 
+                <code style="font-family: monospace;">{{datetime}}</code>, 
+                <code style="font-family: monospace;">{{title}}</code>, 
+                <code style="font-family: monospace;">{{folder}}</code>
+            </div>
+            
+            <!-- Empty state when no templates available -->
+            <div x-show="availableTemplates.length === 0" class="mb-4 text-sm p-3 rounded" style="background-color: var(--bg-tertiary); color: var(--text-secondary);">
+                No templates found. Create templates in the <code style="font-family: monospace;">_templates</code> folder.
+            </div>
+            
+            <!-- Actions -->
+            <div class="flex gap-2">
+                <button 
+                    @click="createNoteFromTemplate()"
+                    :disabled="!selectedTemplate || !newTemplateNoteName.trim() || availableTemplates.length === 0"
+                    class="flex-1 px-4 py-2 rounded font-medium text-white transition-colors"
+                    style="background-color: var(--accent-primary);"
+                    :style="(!selectedTemplate || !newTemplateNoteName.trim() || availableTemplates.length === 0) ? 'opacity: 0.5; cursor: not-allowed;' : ''"
+                    onmouseover="if(!this.disabled) this.style.backgroundColor='var(--accent-hover)'"
+                    onmouseout="if(!this.disabled) this.style.backgroundColor='var(--accent-primary)'"
+                >
+                    Create Note
+                </button>
+                <button 
+                    @click="showTemplateModal = false; selectedTemplate = ''; newTemplateNoteName = ''"
+                    class="flex-1 px-4 py-2 rounded font-medium transition-colors"
+                    style="background-color: var(--bg-tertiary); color: var(--text-primary);"
+                    onmouseover="this.style.backgroundColor='var(--bg-hover)'"
+                    onmouseout="this.style.backgroundColor='var(--bg-tertiary)'"
+                >
+                    Cancel
+                </button>
+            </div>
+        </div>
+    </div>
+    
     <script src="/static/app.js"></script>
 </body>
 </html>

From 3bc63178dca81258a9d2cfd1e93ebb9583665261 Mon Sep 17 00:00:00 2001
From: Gamosoft <gamosoft@users.noreply.github.com>
Date: Wed, 26 Nov 2025 11:30:33 +0100
Subject: [PATCH 2/9] escape key support

---
 frontend/index.html | 1 +
 1 file changed, 1 insertion(+)

diff --git a/frontend/index.html b/frontend/index.html
index 319e40c..e528671 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -1631,6 +1631,7 @@
     <!-- Template Selection Modal -->
     <div x-show="showTemplateModal" 
          @click.self="showTemplateModal = false; selectedTemplate = ''; newTemplateNoteName = ''"
+         @keydown.escape.window="showTemplateModal && (showTemplateModal = false, selectedTemplate = '', newTemplateNoteName = '')"
          class="fixed inset-0 flex items-center justify-center z-50"
          style="background-color: rgba(0, 0, 0, 0.5);"
          x-cloak>

From 54df891e945fcc65639609758115b7f3b29481a9 Mon Sep 17 00:00:00 2001
From: Gamosoft <gamosoft@users.noreply.github.com>
Date: Wed, 26 Nov 2025 11:40:20 +0100
Subject: [PATCH 3/9] added hamburger menu to landing page

---
 frontend/index.html | 28 +++++++++++++++++++++++++---
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/frontend/index.html b/frontend/index.html
index e528671..54114cb 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -615,6 +615,12 @@
         }
         
         /* Mobile Responsive Styles */
+        /* Z-index hierarchy (for reference):
+           - Mobile sidebar: 1000
+           - Mobile overlay: 999
+           - Template modal: 1100 (must be above sidebar)
+           - Dropdown menu: 50 (below everything)
+        */
         @media (max-width: 768px) {
             /* Hide sidebar by default on mobile */
             .mobile-sidebar {
@@ -946,7 +952,7 @@
                             <span>New Folder</span>
                         </button>
                         <button 
-                            @click.stop="showTemplateModal = true; showNewDropdown = false"
+                            @click.stop="showTemplateModal = true; showNewDropdown = false; mobileSidebarOpen = false"
                             class="w-full px-4 py-2.5 text-sm text-left flex items-center gap-3 transition-colors"
                             style="color: var(--text-primary);"
                             onmouseover="this.style.backgroundColor='var(--bg-hover)'"
@@ -1151,6 +1157,22 @@
             <template x-if="!currentNote && !currentImage">
                 <!-- Notes Homepage -->
                 <div class="flex-1 overflow-y-auto custom-scrollbar" style="background-color: var(--bg-primary);">
+                    <!-- Mobile Menu Button (Homepage) -->
+                    <div class="mobile-menu-button px-4 py-3" style="background-color: var(--bg-secondary); border-bottom: 1px solid var(--border-primary); display: none;">
+                        <button 
+                            @click="mobileSidebarOpen = !mobileSidebarOpen"
+                            class="p-2 rounded-lg"
+                            style="color: var(--text-primary);"
+                            onmouseover="this.style.backgroundColor='var(--bg-hover)'"
+                            onmouseout="this.style.backgroundColor='transparent'"
+                            title="Toggle sidebar"
+                        >
+                            <svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h16"></path>
+                            </svg>
+                        </button>
+                    </div>
+                    
                     <!-- Welcome Hero - Show when app is empty -->
                     <template x-if="isAppEmpty">
                         <div class="flex flex-col items-center justify-center h-full py-16 text-center">
@@ -1632,8 +1654,8 @@
     <div x-show="showTemplateModal" 
          @click.self="showTemplateModal = false; selectedTemplate = ''; newTemplateNoteName = ''"
          @keydown.escape.window="showTemplateModal && (showTemplateModal = false, selectedTemplate = '', newTemplateNoteName = '')"
-         class="fixed inset-0 flex items-center justify-center z-50"
-         style="background-color: rgba(0, 0, 0, 0.5);"
+         class="fixed inset-0 flex items-center justify-center"
+         style="background-color: rgba(0, 0, 0, 0.5); z-index: 1100;"
          x-cloak>
         <div class="rounded-lg shadow-xl p-6 max-w-md w-full mx-4"
              style="background-color: var(--bg-secondary); color: var(--text-primary);"

From 8d78c278ee9e58558ad86e4282bb97bcb3504702 Mon Sep 17 00:00:00 2001
From: Gamosoft <gamosoft@users.noreply.github.com>
Date: Wed, 26 Nov 2025 12:01:50 +0100
Subject: [PATCH 4/9] added path security, documented api endpoints

---
 backend/main.py      |   6 +-
 backend/utils.py     |  10 +++
 documentation/API.md | 150 +++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 164 insertions(+), 2 deletions(-)

diff --git a/backend/main.py b/backend/main.py
index 37869f9..ad60af4 100644
--- a/backend/main.py
+++ b/backend/main.py
@@ -783,7 +783,8 @@ async def get_notes_by_tag_endpoint(tag_name: str):
 # --- Template Endpoints ---
 
 @api_router.get("/templates")
-async def list_templates():
+@limiter.limit("120/minute")
+async def list_templates(request: Request):
     """
     List all available templates from _templates folder.
     
@@ -798,7 +799,8 @@ async def list_templates():
 
 
 @api_router.get("/templates/{template_name}")
-async def get_template(template_name: str):
+@limiter.limit("120/minute")
+async def get_template(request: Request, template_name: str):
     """
     Get content of a specific template.
     
diff --git a/backend/utils.py b/backend/utils.py
index cd69ff3..4d97d8b 100644
--- a/backend/utils.py
+++ b/backend/utils.py
@@ -668,9 +668,19 @@ def get_templates(notes_dir: str) -> List[Dict]:
     if not templates_path.exists():
         return templates
     
+    # Security check: ensure _templates folder is within notes directory
+    if not validate_path_security(notes_dir, templates_path):
+        print(f"Security: Templates directory is outside notes directory: {templates_path}")
+        return templates
+    
     try:
         for template_file in templates_path.glob("*.md"):
             try:
+                # Security check: ensure each template is within notes directory
+                if not validate_path_security(notes_dir, template_file):
+                    print(f"Security: Skipping template outside notes directory: {template_file}")
+                    continue
+                
                 stat = template_file.stat()
                 templates.append({
                     "name": template_file.stem,
diff --git a/documentation/API.md b/documentation/API.md
index 96385bd..3590808 100644
--- a/documentation/API.md
+++ b/documentation/API.md
@@ -295,6 +295,120 @@ Self-documenting endpoint listing all available API routes.
 
 ---
 
+## 🏷️ Tags
+
+### List All Tags
+`GET /api/tags`
+
+Returns all tags found in notes with their usage counts.
+
+**Response:**
+```json
+{
+  "tags": {
+    "python": 5,
+    "tutorial": 3,
+    "backend": 2
+  }
+}
+```
+
+### Get Notes by Tag
+`GET /api/tags/{tag_name}`
+
+Returns all notes that have a specific tag.
+
+**Response:**
+```json
+{
+  "tag": "python",
+  "notes": [
+    {
+      "path": "tutorials/python-basics.md",
+      "name": "python-basics",
+      "folder": "tutorials",
+      "tags": ["python", "tutorial"]
+    }
+  ]
+}
+```
+
+---
+
+## 📄 Templates
+
+### List Templates
+`GET /api/templates`
+
+Returns all available note templates from the `_templates` folder.
+
+**Response:**
+```json
+{
+  "templates": [
+    {
+      "name": "meeting-notes",
+      "path": "_templates/meeting-notes.md",
+      "modified": "2025-11-26T10:30:00"
+    },
+    {
+      "name": "daily-journal",
+      "path": "_templates/daily-journal.md",
+      "modified": "2025-11-26T10:25:00"
+    }
+  ]
+}
+```
+
+### Get Template Content
+`GET /api/templates/{template_name}`
+
+Returns the content of a specific template.
+
+**Parameters:**
+- `template_name` - Template name (without .md extension)
+
+**Response:**
+```json
+{
+  "name": "meeting-notes",
+  "content": "# Meeting Notes\n\nDate: {{date}}\n..."
+}
+```
+
+### Create Note from Template
+`POST /api/templates/create-note`
+
+Creates a new note from a template with placeholder replacement.
+
+**Request Body:**
+```json
+{
+  "templateName": "meeting-notes",
+  "notePath": "meetings/weekly-sync.md"
+}
+```
+
+**Placeholders:**
+- `{{date}}` - Current date (YYYY-MM-DD)
+- `{{time}}` - Current time (HH:MM:SS)
+- `{{datetime}}` - Current datetime
+- `{{timestamp}}` - Unix timestamp
+- `{{title}}` - Note name without extension
+- `{{folder}}` - Parent folder name
+
+**Response:**
+```json
+{
+  "success": true,
+  "path": "meetings/weekly-sync.md",
+  "message": "Note created from template successfully",
+  "content": "# Meeting Notes\n\nDate: 2025-11-26\n..."
+}
+```
+
+---
+
 ## 📝 Response Format
 
 All endpoints return JSON responses:
@@ -315,5 +429,41 @@ All endpoints return JSON responses:
 ```
 ---
 
+---
+
+## 🔒 Security & Rate Limiting
+
+### Authentication
+When authentication is enabled (via `AUTHENTICATION_ENABLED` environment variable or `config.yaml`), all API endpoints require a valid session cookie obtained through the `/login` endpoint.
+
+### Rate Limiting
+When `DEMO_MODE` is enabled, the following rate limits are enforced:
+
+**Read Operations:**
+- `GET /api/notes` - 120/minute
+- `GET /api/templates` - 120/minute
+- `GET /api/templates/{template_name}` - 120/minute
+- `GET /api/tags` - 120/minute
+- `GET /api/tags/{tag}` - 120/minute
+
+**Write Operations:**
+- `POST /api/notes` - 60/minute
+- `DELETE /api/notes/*` - 60/minute
+- `POST /api/folders` - 60/minute
+- `DELETE /api/folders/*` - 60/minute
+- `POST /api/images/upload` - 30/minute
+- `DELETE /api/images/*` - 60/minute
+- `POST /api/templates/create-note` - 60/minute
+- `POST /api/plugins/*/toggle` - 60/minute
+
+### Path Security
+All file operations validate that paths are within the configured `notes_dir` to prevent directory traversal attacks. This includes:
+- Note operations
+- Folder operations
+- Image operations
+- Template operations
+
+---
+
 💡 **Tip:** Use the `/api` endpoint to get a live, self-documented list of all available endpoints!
 

From 01ea9f600825f3aa70b7fe2201b8e1c3db552cb3 Mon Sep 17 00:00:00 2001
From: Gamosoft <gamosoft@users.noreply.github.com>
Date: Wed, 26 Nov 2025 12:43:37 +0100
Subject: [PATCH 5/9] first attempt to get unified item creation menu

---
 documentation/API.md | 36 ----------------------------
 frontend/app.js      | 56 ++++++++++++++++++++++++--------------------
 2 files changed, 30 insertions(+), 62 deletions(-)

diff --git a/documentation/API.md b/documentation/API.md
index 3590808..fd3c567 100644
--- a/documentation/API.md
+++ b/documentation/API.md
@@ -429,41 +429,5 @@ All endpoints return JSON responses:
 ```
 ---
 
----
-
-## 🔒 Security & Rate Limiting
-
-### Authentication
-When authentication is enabled (via `AUTHENTICATION_ENABLED` environment variable or `config.yaml`), all API endpoints require a valid session cookie obtained through the `/login` endpoint.
-
-### Rate Limiting
-When `DEMO_MODE` is enabled, the following rate limits are enforced:
-
-**Read Operations:**
-- `GET /api/notes` - 120/minute
-- `GET /api/templates` - 120/minute
-- `GET /api/templates/{template_name}` - 120/minute
-- `GET /api/tags` - 120/minute
-- `GET /api/tags/{tag}` - 120/minute
-
-**Write Operations:**
-- `POST /api/notes` - 60/minute
-- `DELETE /api/notes/*` - 60/minute
-- `POST /api/folders` - 60/minute
-- `DELETE /api/folders/*` - 60/minute
-- `POST /api/images/upload` - 30/minute
-- `DELETE /api/images/*` - 60/minute
-- `POST /api/templates/create-note` - 60/minute
-- `POST /api/plugins/*/toggle` - 60/minute
-
-### Path Security
-All file operations validate that paths are within the configured `notes_dir` to prevent directory traversal attacks. This includes:
-- Note operations
-- Folder operations
-- Image operations
-- Template operations
-
----
-
 💡 **Tip:** Use the `/api` endpoint to get a live, self-documented list of all available endpoints!
 
diff --git a/frontend/app.js b/frontend/app.js
index 49364ef..9d7fc7e 100644
--- a/frontend/app.js
+++ b/frontend/app.js
@@ -99,6 +99,7 @@ function noteApp() {
         
         // Dropdown state
         showNewDropdown: false,
+        dropdownTargetFolder: '', // Folder context for "New" dropdown (empty = root)
         
         // Template state
         showTemplateModal: false,
@@ -620,15 +621,16 @@ function noteApp() {
             }
             
             try {
-                // Determine the note path based on current context
+                // Determine the note path based on dropdown context
                 let notePath = this.newTemplateNoteName.trim();
                 if (!notePath.endsWith('.md')) {
                     notePath += '.md';
                 }
                 
-                // If we're in a folder on the homepage, create in that folder
-                if (this.selectedHomepageFolder) {
-                    notePath = `${this.selectedHomepageFolder}/${notePath}`;
+                // If we have a target folder context, create in that folder
+                if (this.dropdownTargetFolder || this.selectedHomepageFolder) {
+                    const targetFolder = this.dropdownTargetFolder || this.selectedHomepageFolder;
+                    notePath = `${targetFolder}/${notePath}`;
                 }
                 
                 // Create note from template
@@ -980,17 +982,11 @@ function noteApp() {
                         </div>
                         <div class="hover-buttons flex gap-1 transition-opacity absolute right-2 top-1/2 transform -translate-y-1/2" style="opacity: 0; pointer-events: none; background: linear-gradient(to right, transparent, var(--bg-hover) 20%, var(--bg-hover)); padding-left: 20px;" @click.stop>
                             <button 
-                                @click="createNote('${folder.path.replace(/'/g, "\\'")}')"
+                                @click="dropdownTargetFolder = '${folder.path.replace(/'/g, "\\'")}'; showNewDropdown = !showNewDropdown"
                                 class="px-1.5 py-0.5 text-xs rounded hover:brightness-110"
                                 style="background-color: var(--bg-tertiary); color: var(--text-secondary);"
-                                title="New note here"
-                            >📄</button>
-                            <button 
-                                @click="createFolder('${folder.path.replace(/'/g, "\\'")}')"
-                                class="px-1.5 py-0.5 text-xs rounded hover:brightness-110"
-                                style="background-color: var(--bg-tertiary); color: var(--text-secondary);"
-                                title="New subfolder"
-                            >📁</button>
+                                title="Add item here"
+                            >+</button>
                             <button 
                                 @click="renameFolder('${folder.path.replace(/'/g, "\\'")}', '${folder.name.replace(/'/g, "\\'")}')"
                                 class="px-1.5 py-0.5 text-xs rounded hover:brightness-110"
@@ -1971,21 +1967,27 @@ function noteApp() {
         
         toggleNewDropdown() {
             this.showNewDropdown = !this.showNewDropdown;
+            if (this.showNewDropdown) {
+                this.dropdownTargetFolder = ''; // Set to root when opening main dropdown
+            }
         },
         
         closeDropdown() {
             this.showNewDropdown = false;
+            this.dropdownTargetFolder = ''; // Reset folder context
         },
         
         // =====================================================
         // UNIFIED CREATION FUNCTIONS (reusable from anywhere)
         // =====================================================
         
-        async createNote(folderPath = '') {
+        async createNote(folderPath = null) {
+            // Use provided folder path, or dropdown target folder context
+            const targetFolder = folderPath !== null ? folderPath : this.dropdownTargetFolder;
             this.closeDropdown();
             
-            const promptText = folderPath 
-                ? `Create note in "${folderPath}".\nEnter note name:`
+            const promptText = targetFolder 
+                ? `Create note in "${targetFolder}".\nEnter note name:`
                 : 'Enter note name (you can use folder/name):';
             
             const noteName = prompt(promptText);
@@ -1998,8 +2000,8 @@ function noteApp() {
             }
             
             let notePath;
-            if (folderPath) {
-                notePath = `${folderPath}/${sanitizedName}.md`;
+            if (targetFolder) {
+                notePath = `${targetFolder}/${sanitizedName}.md`;
             } else {
                 notePath = sanitizedName.endsWith('.md') ? sanitizedName : `${sanitizedName}.md`;
             }
@@ -2019,8 +2021,8 @@ function noteApp() {
                 });
                 
                 if (response.ok) {
-                    if (folderPath) {
-                        this.expandedFolders.add(folderPath);
+                    if (targetFolder) {
+                        this.expandedFolders.add(targetFolder);
                     }
                     await this.loadNotes();
                     await this.loadNote(notePath);
@@ -2032,11 +2034,13 @@ function noteApp() {
             }
         },
         
-        async createFolder(parentPath = '') {
+        async createFolder(parentPath = null) {
+            // Use provided parent path, or dropdown target folder context
+            const targetFolder = parentPath !== null ? parentPath : this.dropdownTargetFolder;
             this.closeDropdown();
             
-            const promptText = parentPath 
-                ? `Create subfolder in "${parentPath}".\nEnter folder name:`
+            const promptText = targetFolder 
+                ? `Create subfolder in "${targetFolder}".\nEnter folder name:`
                 : 'Create new folder.\nEnter folder path (e.g., "Projects" or "Work/2025"):';
             
             const folderName = prompt(promptText);
@@ -2048,7 +2052,7 @@ function noteApp() {
                 return;
             }
             
-            const folderPath = parentPath ? `${parentPath}/${sanitizedName}` : sanitizedName;
+            const folderPath = targetFolder ? `${targetFolder}/${sanitizedName}` : sanitizedName;
             
             // Check if folder already exists
             const existingFolder = this.allFolders.find(folder => folder === folderPath);
@@ -2065,8 +2069,8 @@ function noteApp() {
                 });
                 
                 if (response.ok) {
-                    if (parentPath) {
-                        this.expandedFolders.add(parentPath);
+                    if (targetFolder) {
+                        this.expandedFolders.add(targetFolder);
                     }
                     this.expandedFolders.add(folderPath);
                     await this.loadNotes();

From f256aef4077c113d1ac349ddee5e74f54e7b3161 Mon Sep 17 00:00:00 2001
From: Gamosoft <gamosoft@users.noreply.github.com>
Date: Wed, 26 Nov 2025 14:38:47 +0100
Subject: [PATCH 6/9] contextual new item

---
 frontend/app.js     | 27 ++++++++++---
 frontend/index.html | 99 +++++++++++++++++++++++----------------------
 2 files changed, 72 insertions(+), 54 deletions(-)

diff --git a/frontend/app.js b/frontend/app.js
index 9d7fc7e..811f718 100644
--- a/frontend/app.js
+++ b/frontend/app.js
@@ -100,6 +100,7 @@ function noteApp() {
         // Dropdown state
         showNewDropdown: false,
         dropdownTargetFolder: '', // Folder context for "New" dropdown (empty = root)
+        dropdownPosition: { top: 0, left: 0 }, // Position for contextual dropdown
         
         // Template state
         showTemplateModal: false,
@@ -982,7 +983,7 @@ function noteApp() {
                         </div>
                         <div class="hover-buttons flex gap-1 transition-opacity absolute right-2 top-1/2 transform -translate-y-1/2" style="opacity: 0; pointer-events: none; background: linear-gradient(to right, transparent, var(--bg-hover) 20%, var(--bg-hover)); padding-left: 20px;" @click.stop>
                             <button 
-                                @click="dropdownTargetFolder = '${folder.path.replace(/'/g, "\\'")}'; showNewDropdown = !showNewDropdown"
+                                @click="dropdownTargetFolder = '${folder.path.replace(/'/g, "\\'")}'; toggleNewDropdown($event)"
                                 class="px-1.5 py-0.5 text-xs rounded hover:brightness-110"
                                 style="background-color: var(--bg-tertiary); color: var(--text-secondary);"
                                 title="Add item here"
@@ -1965,10 +1966,26 @@ function noteApp() {
         // DROPDOWN MENU SYSTEM
         // =====================================================
         
-        toggleNewDropdown() {
-            this.showNewDropdown = !this.showNewDropdown;
-            if (this.showNewDropdown) {
-                this.dropdownTargetFolder = ''; // Set to root when opening main dropdown
+        toggleNewDropdown(event) {
+            this.showNewDropdown = true; // Always open (or keep open)
+            
+            if (event && event.target) {
+                const rect = event.target.getBoundingClientRect();
+                // Position dropdown next to the clicked element
+                let top = rect.bottom + 4; // 4px spacing
+                let left = rect.left;
+                
+                // Keep dropdown on screen
+                const dropdownWidth = 200;
+                const dropdownHeight = 150;
+                if (left + dropdownWidth > window.innerWidth) {
+                    left = rect.right - dropdownWidth;
+                }
+                if (top + dropdownHeight > window.innerHeight) {
+                    top = rect.top - dropdownHeight - 4;
+                }
+                
+                this.dropdownPosition = { top, left };
             }
         },
         
diff --git a/frontend/index.html b/frontend/index.html
index 54114cb..9d89623 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -903,9 +903,9 @@
             </div>
             
             <!-- New Item Dropdown -->
-            <div class="p-3 border-b relative" style="border-color: var(--border-primary);">
+            <div class="p-3 border-b" style="border-color: var(--border-primary);">
                 <button 
-                    @click="toggleNewDropdown()"
+                    @click="dropdownTargetFolder = ''; toggleNewDropdown($event)"
                     class="w-full px-4 py-2 text-sm font-medium text-white rounded-lg focus:outline-none focus:ring-2 flex items-center justify-center gap-2"
                     style="background-color: var(--accent-primary);"
                     onmouseover="this.style.backgroundColor='var(--accent-hover)'"
@@ -916,53 +916,6 @@
                         <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7"></path>
                     </svg>
                 </button>
-                
-                <!-- Dropdown Menu -->
-                <div 
-                    x-show="showNewDropdown"
-                    @click.outside="closeDropdown()"
-                    x-transition:enter="transition ease-out duration-100"
-                    x-transition:enter-start="transform opacity-0 scale-95"
-                    x-transition:enter-end="transform opacity-100 scale-100"
-                    x-transition:leave="transition ease-in duration-75"
-                    x-transition:leave-start="transform opacity-100 scale-100"
-                    x-transition:leave-end="transform opacity-0 scale-95"
-                    class="absolute left-3 right-3 mt-2 rounded-lg shadow-lg z-50"
-                    style="background-color: var(--bg-secondary); border: 1px solid var(--border-primary);"
-                >
-                    <div class="py-1">
-                <button 
-                            @click="createNote()"
-                            class="w-full px-4 py-2.5 text-sm text-left flex items-center gap-3 transition-colors"
-                            style="color: var(--text-primary);"
-                            onmouseover="this.style.backgroundColor='var(--bg-hover)'"
-                            onmouseout="this.style.backgroundColor='transparent'"
-                        >
-                            <span class="text-lg">📝</span>
-                            <span>New Note</span>
-                        </button>
-                        <button 
-                            @click="createFolder()"
-                            class="w-full px-4 py-2.5 text-sm text-left flex items-center gap-3 transition-colors"
-                            style="color: var(--text-primary);"
-                            onmouseover="this.style.backgroundColor='var(--bg-hover)'"
-                            onmouseout="this.style.backgroundColor='transparent'"
-                        >
-                            <span class="text-lg">📁</span>
-                            <span>New Folder</span>
-                        </button>
-                        <button 
-                            @click.stop="showTemplateModal = true; showNewDropdown = false; mobileSidebarOpen = false"
-                            class="w-full px-4 py-2.5 text-sm text-left flex items-center gap-3 transition-colors"
-                            style="color: var(--text-primary);"
-                            onmouseover="this.style.backgroundColor='var(--bg-hover)'"
-                            onmouseout="this.style.backgroundColor='transparent'"
-                        >
-                            <span class="text-lg">📄</span>
-                            <span>New from Template</span>
-                        </button>
-                    </div>
-                </div>
             </div>
             
             <!-- Notes List -->
@@ -1650,6 +1603,54 @@
         </div>
     </div>
     
+    <!-- Contextual New Item Dropdown -->
+    <div 
+        x-show="showNewDropdown"
+        @click.outside="closeDropdown()"
+        x-transition:enter="transition ease-out duration-100"
+        x-transition:enter-start="transform opacity-0 scale-95"
+        x-transition:enter-end="transform opacity-100 scale-100"
+        x-transition:leave="transition ease-in duration-75"
+        x-transition:leave-start="transform opacity-100 scale-100"
+        x-transition:leave-end="transform opacity-0 scale-95"
+        class="rounded-lg shadow-lg"
+        :style="`position: fixed; top: ${dropdownPosition.top}px; left: ${dropdownPosition.left}px; z-index: 1000; background-color: var(--bg-secondary); border: 1px solid var(--border-primary); min-width: 200px;`"
+        x-cloak
+    >
+        <div class="py-1">
+            <button 
+                @click="createNote()"
+                class="w-full px-4 py-2.5 text-sm text-left flex items-center gap-3 transition-colors"
+                style="color: var(--text-primary);"
+                onmouseover="this.style.backgroundColor='var(--bg-hover)'"
+                onmouseout="this.style.backgroundColor='transparent'"
+            >
+                <span class="text-lg">📝</span>
+                <span>New Note</span>
+            </button>
+            <button 
+                @click="createFolder()"
+                class="w-full px-4 py-2.5 text-sm text-left flex items-center gap-3 transition-colors"
+                style="color: var(--text-primary);"
+                onmouseover="this.style.backgroundColor='var(--bg-hover)'"
+                onmouseout="this.style.backgroundColor='transparent'"
+            >
+                <span class="text-lg">📁</span>
+                <span>New Folder</span>
+            </button>
+            <button 
+                @click.stop="showTemplateModal = true; showNewDropdown = false; mobileSidebarOpen = false"
+                class="w-full px-4 py-2.5 text-sm text-left flex items-center gap-3 transition-colors"
+                style="color: var(--text-primary);"
+                onmouseover="this.style.backgroundColor='var(--bg-hover)'"
+                onmouseout="this.style.backgroundColor='transparent'"
+            >
+                <span class="text-lg">📄</span>
+                <span>New from Template</span>
+            </button>
+        </div>
+    </div>
+    
     <!-- Template Selection Modal -->
     <div x-show="showTemplateModal" 
          @click.self="showTemplateModal = false; selectedTemplate = ''; newTemplateNoteName = ''"

From fe60c508c6da94945b8ef49d58d8dccf0b58f6bf Mon Sep 17 00:00:00 2001
From: Gamosoft <gamosoft@users.noreply.github.com>
Date: Wed, 26 Nov 2025 14:45:48 +0100
Subject: [PATCH 7/9] added features to landing page

---
 docs/index.html | 38 +++++++++++++++++++++++++++++++++-----
 1 file changed, 33 insertions(+), 5 deletions(-)

diff --git a/docs/index.html b/docs/index.html
index e9f3244..0363973 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -7,8 +7,8 @@
     <!-- Primary Meta Tags -->
     <title>NoteDiscovery - Your Self-Hosted Knowledge Base</title>
     <meta name="title" content="NoteDiscovery - Your Self-Hosted Knowledge Base">
-    <meta name="description" content="A lightweight, privacy-focused Markdown note-taking application with LaTeX math, Mermaid diagrams, and code highlighting. Self-hosted, free, and open source.">
-    <meta name="keywords" content="note taking, markdown editor, self-hosted, knowledge base, open source, privacy, notes app, docker, second brain, obsidian alternative, notion, evernote, onenote, latex, mermaid, diagrams, math equations">
+    <meta name="description" content="A lightweight, privacy-focused Markdown note-taking application with LaTeX math, Mermaid diagrams, tags, templates, and code highlighting. Self-hosted, free, and open source.">
+    <meta name="keywords" content="note taking, markdown editor, self-hosted, knowledge base, open source, privacy, notes app, docker, second brain, obsidian alternative, notion, evernote, onenote, latex, mermaid, diagrams, math equations, templates, tags, yaml frontmatter">
     <meta name="author" content="Gamosoft">
     <meta name="robots" content="index, follow">
     <link rel="canonical" href="https://www.notediscovery.com">
@@ -17,7 +17,7 @@
     <meta property="og:type" content="website">
     <meta property="og:url" content="https://www.notediscovery.com">
     <meta property="og:title" content="NoteDiscovery - Your Self-Hosted Knowledge Base">
-    <meta property="og:description" content="A lightweight, privacy-focused Markdown note-taking application with LaTeX math, Mermaid diagrams, and code highlighting. Self-hosted, free, and open source.">
+    <meta property="og:description" content="A lightweight, privacy-focused Markdown note-taking application with LaTeX math, Mermaid diagrams, tags, templates, and code highlighting. Self-hosted, free, and open source.">
     <meta property="og:image" content="https://www.notediscovery.com/og-image.png">
     <meta property="og:image:width" content="1200">
     <meta property="og:image:height" content="630">
@@ -28,7 +28,7 @@
     <meta name="twitter:site" content="@gamosoft">
     <meta name="twitter:creator" content="@gamosoft">
     <meta name="twitter:title" content="NoteDiscovery - Your Self-Hosted Knowledge Base">
-    <meta name="twitter:description" content="A lightweight, privacy-focused note-taking application with LaTeX math, Mermaid diagrams, and code highlighting. Self-hosted, free, and open source.">
+    <meta name="twitter:description" content="A lightweight, privacy-focused note-taking application with LaTeX math, Mermaid diagrams, tags, templates, and code highlighting. Self-hosted, free, and open source.">
     <meta name="twitter:image" content="https://www.notediscovery.com/og-image.png">
     <meta name="twitter:image:alt" content="NoteDiscovery - Self-hosted note-taking application interface">
     
@@ -509,7 +509,7 @@
         <div class="hero">
             <div class="hero-content">
                 <h2>Take Control of Your Notes</h2>
-                <p>A lightweight, privacy-focused note-taking application with powerful features: LaTeX math equations, Mermaid diagrams, code highlighting, and more. Write, organize, and discover your notes with a beautiful, modern interface—all running on your own server.</p>
+                <p>A lightweight, privacy-focused note-taking application with powerful features: LaTeX math equations, Mermaid diagrams, smart tags, custom templates, code highlighting, and more. Write, organize, and discover your notes with a beautiful, modern interface—all running on your own server.</p>
                 <a href="https://github.com/gamosoft/NoteDiscovery" class="cta-button">Get Started on GitHub →</a>
             </div>
         </div>
@@ -568,6 +568,18 @@
                 <p>Syntax highlighting for popular coding languages. Developer-friendly notes.</p>
             </div>
 
+            <div class="feature">
+                <div class="feature-icon">🏷️</div>
+                <h3>Smart Tags</h3>
+                <p>Organize with YAML frontmatter tags. Filter and discover notes instantly.</p>
+            </div>
+
+            <div class="feature">
+                <div class="feature-icon">📋</div>
+                <h3>Note Templates</h3>
+                <p>Create from custom templates with dynamic placeholders. Meeting notes, journals, and more.</p>
+            </div>
+
             <div class="feature">
                 <div class="feature-icon">📂</div>
                 <h3>Simple Storage</h3>
@@ -638,6 +650,22 @@
                     </div>
                 </div>
 
+                <div class="benefit-item">
+                    <span class="emoji">🏷️</span>
+                    <div class="text">
+                        <strong>Smart Tagging</strong>
+                        Organize and filter with tags
+                    </div>
+                </div>
+
+                <div class="benefit-item">
+                    <span class="emoji">📋</span>
+                    <div class="text">
+                        <strong>Quick Templates</strong>
+                        Reusable note structures
+                    </div>
+                </div>
+
                 <div class="benefit-item">
                     <span class="emoji">🔗</span>
                     <div class="text">

From c3314e2da4c591f4f1f9cfc5a0a936e09957c0b3 Mon Sep 17 00:00:00 2001
From: Gamosoft <gamosoft@users.noreply.github.com>
Date: Wed, 26 Nov 2025 14:48:54 +0100
Subject: [PATCH 8/9] rearranging features

---
 docs/index.html | 26 +++++++++-----------------
 1 file changed, 9 insertions(+), 17 deletions(-)

diff --git a/docs/index.html b/docs/index.html
index 0363973..f8dbcc8 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -650,27 +650,19 @@
                     </div>
                 </div>
 
-                <div class="benefit-item">
-                    <span class="emoji">🏷️</span>
-                    <div class="text">
-                        <strong>Smart Tagging</strong>
-                        Organize and filter with tags
-                    </div>
-                </div>
-
-                <div class="benefit-item">
-                    <span class="emoji">📋</span>
-                    <div class="text">
-                        <strong>Quick Templates</strong>
-                        Reusable note structures
-                    </div>
-                </div>
-
                 <div class="benefit-item">
                     <span class="emoji">🔗</span>
                     <div class="text">
                         <strong>Internal Links</strong>
-                        Connect notes with markdown links
+                        Connect notes with backlinks
+                    </div>
+                </div>
+
+                <div class="benefit-item">
+                    <span class="emoji">🖼️</span>
+                    <div class="text">
+                        <strong>Image Support</strong>
+                        Drag & drop images directly
                     </div>
                 </div>
 

From 04fc526881fc68f6758be3e5af6e747aac17cfae Mon Sep 17 00:00:00 2001
From: Gamosoft <gamosoft@users.noreply.github.com>
Date: Wed, 26 Nov 2025 15:03:17 +0100
Subject: [PATCH 9/9] added templating info

---
 README.md                                |   1 +
 documentation/FEATURES.md                |   2 +
 documentation/TEMPLATES.md               | 135 +++++++++++++++++++++++
 documentation/templates/daily-journal.md |  25 +++++
 documentation/templates/meeting-notes.md |  24 ++++
 documentation/templates/project-plan.md  |  34 ++++++
 6 files changed, 221 insertions(+)
 create mode 100644 documentation/TEMPLATES.md
 create mode 100644 documentation/templates/daily-journal.md
 create mode 100644 documentation/templates/meeting-notes.md
 create mode 100644 documentation/templates/project-plan.md

diff --git a/README.md b/README.md
index a42a0b9..31991e6 100644
--- a/README.md
+++ b/README.md
@@ -210,6 +210,7 @@ Want to learn more?
 - 🎨 **[THEMES.md](documentation/THEMES.md)** - Theme customization and creating custom themes
 - ✨ **[FEATURES.md](documentation/FEATURES.md)** - Complete feature list and keyboard shortcuts
 - 🏷️ **[TAGS.md](documentation/TAGS.md)** - Organize notes with tags and combined filtering
+- 📋 **[TEMPLATES.md](documentation/TEMPLATES.md)** - Create notes from reusable templates with dynamic placeholders
 - 🧮 **[MATHJAX.md](documentation/MATHJAX.md)** - LaTeX/Math notation examples and syntax reference
 - 📊 **[MERMAID.md](documentation/MERMAID.md)** - Diagram creation with Mermaid (flowcharts, sequence diagrams, and more)
 - 🔌 **[PLUGINS.md](documentation/PLUGINS.md)** - Plugin system and available plugins
diff --git a/documentation/FEATURES.md b/documentation/FEATURES.md
index 8685a02..9b6be0a 100644
--- a/documentation/FEATURES.md
+++ b/documentation/FEATURES.md
@@ -206,6 +206,8 @@ date: {{date}}
 - **daily-journal** - Daily journal with morning goals and evening reflection
 - **project-plan** - Project planning template with objectives and timeline
 
+📚 **See [TEMPLATES.md](TEMPLATES.md)** for detailed documentation and example templates you can copy to your instance.
+
 ## ⚡ Keyboard Shortcuts
 
 ### General
diff --git a/documentation/TEMPLATES.md b/documentation/TEMPLATES.md
new file mode 100644
index 0000000..fb88c5a
--- /dev/null
+++ b/documentation/TEMPLATES.md
@@ -0,0 +1,135 @@
+# 📋 Note Templates
+
+Create notes from reusable templates with dynamic placeholder replacement.
+
+## Overview
+
+Templates allow you to quickly create notes with predefined structures and content. Perfect for recurring note types like meeting notes, daily journals, project plans, and more.
+
+## How to Use Templates
+
+### 1. Create Template Files
+
+Templates are stored in the `data/_templates/` folder as markdown files. You will need to create such folder if it doesn't exist:
+
+```
+data/
+└── _templates/
+    ├── meeting-notes.md
+    ├── daily-journal.md
+    └── project-plan.md
+```
+
+### 2. Access Templates
+
+Click the **"New"** button (or **+** on any folder) and select **"New from Template"**:
+
+1. Choose a template from the dropdown
+2. Enter a name for your new note
+3. Click "Create Note"
+
+The template will be copied with all placeholders replaced automatically!
+
+### 3. Use Placeholders
+
+Templates support dynamic placeholders that are replaced when you create a note:
+
+| Placeholder | Description | Example |
+|------------|-------------|---------|
+| `{{date}}` | Current date | `2025-11-26` |
+| `{{time}}` | Current time | `14:30:45` |
+| `{{datetime}}` | Current date and time | `2025-11-26 14:30:45` |
+| `{{timestamp}}` | Unix timestamp | `1732632645` |
+| `{{title}}` | Note name (without .md) | `Weekly Meeting` |
+| `{{folder}}` | Parent folder name | `Projects` |
+
+### Example Template
+
+```markdown
+---
+tags: [meeting]
+date: {{date}}
+---
+
+# Meeting Notes - {{title}}
+
+**Date:** {{datetime}}  
+**Participants:** 
+- 
+
+## Agenda
+- 
+
+## Discussion
+
+
+## Action Items
+- [ ] 
+
+## Next Steps
+
+
+```
+
+When you create a note called "Team Sync" from this template, it becomes:
+
+```markdown
+---
+tags: [meeting]
+date: 2025-11-26
+---
+
+# Meeting Notes - Team Sync
+
+**Date:** 2025-11-26 14:30:45  
+**Participants:** 
+- 
+
+## Agenda
+- 
+
+## Discussion
+
+
+## Action Items
+- [ ] 
+
+## Next Steps
+
+
+```
+
+## Example Templates
+
+We provide three example templates in `documentation/templates/` that you can copy to your `data/_templates/` folder:
+
+1. **meeting-notes.md** - Structured meeting notes with agenda, discussion, and action items
+2. **daily-journal.md** - Daily journal with morning goals and evening reflection
+3. **project-plan.md** - Project planning template with objectives, timeline, and status tracking
+
+### Using Example Templates
+
+**Option 1: Copy Manually**
+```bash
+cp documentation/templates/*.md data/_templates/
+```
+
+**Option 2: Create Your Own**
+1. Create a `.md` file in `data/_templates/`
+2. Add content and placeholders
+3. Save and it's ready to use!
+
+## Tips
+
+- ✅ Templates can include YAML frontmatter for tags and metadata
+- ✅ Use descriptive template names (they appear in the dropdown)
+- ✅ Templates work in any folder - the context is preserved
+- ✅ You can edit templates anytime - changes apply to new notes only
+- ✅ Combine templates with tags for powerful organization
+
+---
+
+**See also:**
+- [Tags Documentation](TAGS.md) - Learn about organizing with tags
+- [Features Overview](FEATURES.md) - All application features
+
diff --git a/documentation/templates/daily-journal.md b/documentation/templates/daily-journal.md
new file mode 100644
index 0000000..f3843e9
--- /dev/null
+++ b/documentation/templates/daily-journal.md
@@ -0,0 +1,25 @@
+---
+tags: [journal, daily]
+date: {{date}}
+---
+
+# Daily Journal - {{date}}
+
+## 🌅 Morning
+**Time:** {{time}}
+
+### Goals for Today
+- [ ] 
+- [ ] 
+- [ ] 
+
+## 📝 Notes
+
+
+## 🌙 Evening Reflection
+
+
+## 💡 Ideas
+
+
+
diff --git a/documentation/templates/meeting-notes.md b/documentation/templates/meeting-notes.md
new file mode 100644
index 0000000..220ec44
--- /dev/null
+++ b/documentation/templates/meeting-notes.md
@@ -0,0 +1,24 @@
+---
+tags: [meeting]
+date: {{date}}
+---
+
+# Meeting Notes - {{title}}
+
+**Date:** {{datetime}}  
+**Participants:** 
+- 
+
+## Agenda
+- 
+
+## Discussion
+
+
+## Action Items
+- [ ] 
+
+## Next Steps
+
+
+
diff --git a/documentation/templates/project-plan.md b/documentation/templates/project-plan.md
new file mode 100644
index 0000000..25cee3d
--- /dev/null
+++ b/documentation/templates/project-plan.md
@@ -0,0 +1,34 @@
+---
+tags: [project]
+created: {{datetime}}
+folder: {{folder}}
+---
+
+# Project: {{title}}
+
+## 📋 Overview
+
+
+## 🎯 Objectives
+- 
+
+## 📅 Timeline
+- **Start Date:** {{date}}
+- **Target Completion:** 
+
+## 📦 Deliverables
+- 
+
+## 👥 Team
+
+
+## 📊 Status
+- [ ] Planning
+- [ ] In Progress
+- [ ] Review
+- [ ] Completed
+
+## 📝 Notes
+
+
+