Filename Templates

Filename Templates

Filename templates define how issue and pull request notes are named in your vault.

Default Templates

Type	Default Template	Example Result
Issue	Issue - {number}	Issue - 123.md
Pull Request	PR - {number}	PR - 456.md

Available Variables

All variables from Template-Variables can be used, but these are most useful for filenames:

Variable	Description	Example
{number}	Issue/PR number	123
{title}	Title	Fix login bug
{status}	Status	open
{author}	Author username	lonoxx
{type}	Type	issue, pr
{labels_hash}	Labels as hashtags	#bug #critical
{owner}	Repository owner	LonoxX
{repoName}	Repository name	my-repo
{created}	Creation date	2026-01-15
{updated}	Update date	2026-01-20

Examples

Simple Templates

Issue - {number}              → Issue - 123.md
{number} - {title}            → 123 - Fix login bug.md
{type} {number}               → issue 123.md

With Repository Info

{owner}/{repoName} - {number}           → LonoxX/my-repo - 123.md
{repoName}-{number} {title}             → my-repo-123 Fix login bug.md

With Status

[{status}] {title} ({number})           → [open] Fix login bug (123).md
{number} - {title} [{status}]           → 123 - Fix login bug [open].md

With Labels

{number} {title} {labels_hash}          → 123 Fix login bug #bug #critical.md

With Author

{author} - {number} - {title}           → lonoxx - 123 - Fix login bug.md

Folder Templates (Projects)

For GitHub Projects, folder templates support:

Variable	Description	Example
{project}	Project title	My Project
{owner}	Project owner	LonoxX
{project_number}	Project number	1

Examples

GitHub/{project}                        → GitHub/My Project/
{owner}/Projects/{project}              → LonoxX/Projects/My Project/
Projects/{project_number} - {project}   → Projects/1 - My Project/

Tips

1. Keep it simple - Shorter filenames are easier to link
2. Use {number} - Always include the number for unique identification
3. Avoid special characters - Characters like < > : " | ? * \ / are automatically replaced with -
4. Max length - Filenames are limited to 255 characters

Character Sanitization

The following characters are automatically replaced with -:

• < > : " | ? * \ /
• Newlines and tabs are replaced with spaces
• Leading/trailing dots are removed