docs: add content getter usage documentation

Added documentation tracking all usages of Editor.content and note.content
getters in the Templating plugin. Helps with understanding attachment path
handling and content access patterns.

Author: dwertheimer

np.Templating/content-getter-usage.md

@@ -0,0 +1,237 @@
+# Content Getter Usage in np.Templating
+
+.contentWithAbsoluteAttachmentPaths
+
+Discussion: [Discord](https://discord.com/channels/763107030223290449/1419640432681418836/1427347411923243143)
+
+This document lists all places where `Editor.content` or `note.content` is used as a getter (reading the value) in the np.Templating plugin.
+
+## Summary
+
+- **Total Files**: 4
+- **Editor.content Occurrences**: 6
+- **note.content Occurrences**: 5
+- **paragraph.content Occurrences**: 2 (see separate section below)
+
+---
+
+## Part 1: Editor.content Usage
+
+### File: `src/Templating.js`
+
+#### Function: `templateInsert`
+**[Line 120](src/Templating.js#L120)**
+```javascript
+templateData = Editor.content
+```
+- **Purpose**: Getting current editor content when using `<current>` template
+- **Context**: Using the currently open note as a template
+- **File**: `np.Templating/src/Templating.js:120`
+
+#### Function: `templateAppend`
+**[Line 147](src/Templating.js#L147)**
+```javascript
+const content: string = Editor.content || ''
+```
+- **Purpose**: Getting current editor content for length calculation
+- **Context**: Determining where to append template content
+- **File**: `np.Templating/src/Templating.js:147`
+
+**[Line 158](src/Templating.js#L158)**
+```javascript
+templateData = Editor.content
+```
+- **Purpose**: Getting current editor content when using `<current>` template
+- **Context**: Using the currently open note as a template
+- **File**: `np.Templating/src/Templating.js:158`
+
+#### Function: `templateInvoke`
+**[Line 196](src/Templating.js#L196)**
+```javascript
+const content: string = Editor.content || ''
+```
+- **Purpose**: Getting current editor content (though variable appears unused)
+- **Context**: Initial setup for template invoke
+- **File**: `np.Templating/src/Templating.js:196`
+
+#### Function: `templateQuickNote`
+**[Line 419](src/Templating.js#L419)**
+```javascript
+const content: string = Editor.content || ''
+```
+- **Purpose**: Getting current editor content (though variable appears unused)
+- **Context**: Initial setup for quick note creation
+- **File**: `np.Templating/src/Templating.js:419`
+
+#### Function: `templateMeetingNote`
+**[Line 548](src/Templating.js#L548)**
+```javascript
+const content: string = Editor.content || ''
+```
+- **Purpose**: Getting current editor content (though variable appears unused)
+- **Context**: Initial setup for meeting note creation
+- **File**: `np.Templating/src/Templating.js:548`
+
+#### Function: `templateConvertNote`
+**[Line 844](src/Templating.js#L844)**
+```javascript
+const note = Editor.content || ''
+```
+- **Purpose**: Getting current editor content for conversion
+- **Context**: Converting a project note to frontmatter format
+- **File**: `np.Templating/src/Templating.js:844`
+
+---
+
+## Part 2: note.content Usage
+
+### File: `src/NPTemplateRunner.js`
+
+#### Function: `writeNoteContents`
+**[Line 272](src/NPTemplateRunner.js#L272)**
+```javascript
+`writeNoteContents replaceHeading: note.content.includes(headingParagraph.content): ${String(note.content?.includes(`# ${headingParagraph.content}`))}`,
+```
+- **Purpose**: Checking if note content includes a specific heading
+- **Context**: Debugging/error logging when replacing a heading
+- **File**: `np.Templating/src/NPTemplateRunner.js:272`
+
+#### Function: `getTemplateData`
+**[Line 360](src/NPTemplateRunner.js#L360)**
+```javascript
+templateData = selectedTemplate ? trTemplateNote?.content || '' : ''
+```
+- **Purpose**: Getting template data from a template note
+- **Context**: Loading template content for processing
+- **File**: `np.Templating/src/NPTemplateRunner.js:360`
+
+### File: `src/Templating.js`
+
+#### Function: `templateInsert`
+**[Line 123](src/Templating.js#L123)**
+```javascript
+templateData = templateNote?.content || ''
+```
+- **Purpose**: Getting template data from a template note
+- **Context**: Loading template content for insertion
+- **File**: `np.Templating/src/Templating.js:123`
+
+#### Function: `templateAppend`
+**[Line 161](src/Templating.js#L161)**
+```javascript
+templateData = templateNote?.content || ''
+```
+- **Purpose**: Getting template data from a template note
+- **Context**: Loading template content for appending
+- **File**: `np.Templating/src/Templating.js:161`
+
+### File: `lib/support/modules/NoteModule.js`
+
+#### Function: `content`
+**[Line 55](lib/support/modules/NoteModule.js#L55)**
+```javascript
+let content = this.getCurrentNote()?.content
+```
+- **Purpose**: Getting note content to return (optionally stripping frontmatter)
+- **Context**: Method to access current note's content
+- **File**: `np.Templating/lib/support/modules/NoteModule.js:55`
+
+#### Function: `getRandomLine`
+**[Line 81](lib/support/modules/NoteModule.js#L81)**
+```javascript
+let fullNoteContent = note.content || ''
+```
+- **Purpose**: Getting note content to extract a random line
+- **Context**: Retrieving full note content for processing
+- **File**: `np.Templating/lib/support/modules/NoteModule.js:81`
+
+---
+
+## Part 3: Paragraph Content Usage (para|paragraph|p.content)
+
+**Note**: These are separated out as they are a different use case than Editor/note content.
+
+### File: `src/NPTemplateRunner.js`
+
+#### Function: `replaceHeading`
+**[Line 96](src/NPTemplateRunner.js#L96)**
+```javascript
+const paraMatch = para.content.match(/^#+/)
+```
+- **Purpose**: Getting content from a paragraph to match heading level
+- **Context**: Finding the next heading of same or higher level
+- **File**: `np.Templating/src/NPTemplateRunner.js:96`
+
+**[Line 272](src/NPTemplateRunner.js#L272)** (also referenced in note.content section above)
+```javascript
+`writeNoteContents replaceHeading: note.content.includes(headingParagraph.content): ${String(note.content?.includes(`# ${headingParagraph.content}`))}`,
+```
+- **Purpose**: Getting content from heading paragraph for comparison
+- **Context**: Debugging/error logging when replacing a heading
+- **File**: `np.Templating/src/NPTemplateRunner.js:272`
+
+### File: `lib/support/modules/TasksModule.js`
+
+#### Function: `_ensureBlockIdsForOpenTasks`
+**[Line 94](lib/support/modules/TasksModule.js#L94)**
+```javascript
+const openTaskParagraphs = getOpenTasksAndChildren(note.paragraphs.filter((p) => p.content.trim() !== ''))
+```
+- **Purpose**: Filtering out empty paragraphs by checking content
+- **Context**: Getting open tasks and ensuring they have block IDs
+- **File**: `np.Templating/lib/support/modules/TasksModule.js:94`
+
+---
+
+## Usage Patterns Summary
+
+### Editor.content
+- **Count**: 6 occurrences (all in Templating.js)
+- **Common patterns**:
+  - `Editor.content` - direct access when using `<current>` template
+  - `Editor.content || ''` - with fallback to empty string
+- **Primary uses**:
+  - Getting content when `<current>` is specified as template (2x)
+  - Getting content length for insertion/append operations (1x)
+  - Getting content for note conversion (1x)
+  - Unused variable initialization (3x - lines 196, 419, 548)
+
+### note.content
+- **Count**: 5 occurrences (3 files)
+- **Common patterns**:
+  - `templateNote?.content || ''` - most common pattern for loading templates
+  - `note.content?.includes()` - checking if content contains text
+  - `note.content || ''` - with fallback to empty string
+- **Primary uses**:
+  - Loading template content from template notes (3x)
+  - Checking if content contains specific text (1x - debug logging)
+  - Getting content for processing/conversion (1x)
+
+### paragraph.content
+- **Count**: 2 occurrences (2 files)
+- **Common patterns**:
+  - `para.content.match()` - pattern matching on paragraph content
+  - `p.content.trim()` - checking for empty content
+- **Primary uses**:
+  - Matching heading levels (1x)
+  - Filtering empty paragraphs (1x)
+
+---
+
+## Recommendations
+
+If you're planning to replace direct `.content` access with a function call or different API:
+
+1. **Editor.content** (6 occurrences)
+   - Consider if this needs special handling since it's the active editor
+   - Note: 3 instances appear to be unused variables (lines 196, 419, 548 in Templating.js)
+
+2. **note.content** (5 occurrences)
+   - Most common pattern is `templateNote?.content || ''` for loading templates
+   - Often used with optional chaining `?.content`
+   - One instance is for debug logging only
+
+3. **paragraph.content** (2 occurrences) - SEPARATE USE CASE
+   - Used for filtering and matching operations
+   - May not need to be changed if note/Editor changes are made
+