Skip to content

Example Templates

Jump to bottom
Björn Platte edited this page Aug 12, 2026 · 3 revisions

Example Templates

This page contains ready-to-use templates for issues and pull requests. Copy these to your vault and reference them in the plugin settings.

Default Issue Template

A balanced template with frontmatter and metadata section.

---
title: "{title_yaml}"
number: { number }
status: "{status}"
created: "{created}"
url: "{url}"
opened_by: "{author}"
assignees: { assignees_yaml }
labels: { labels_yaml }
milestone: "{milestone}"
comments: { commentsCount }
locked: { isLocked }
updateMode: "none"
allowDelete: true
---

# {title}

**Issue #{number}** opened by **{author}** on {created}

{body}

## Metadata

- **Status:** {status}
- **Repository:** {repository}
- **Assignees:** {assignees}
- **Labels:** {labels}
- **Comments:** {commentsCount}
- **Created:** {created}
- **Updated:** {updated}
  {closed:- **Closed:** {closed}}
  {milestone:- **Milestone:** {milestone}}

{labels_hash}

---

**[View on GitHub]({url})**

Default PR Template

Template for pull requests with branch information.

---
title: "{title_yaml}"
number: { number }
status: "{status}"
created: "{created}"
url: "{url}"
opened_by: "{author}"
assignees: { assignees_yaml }
labels: { labels_yaml }
milestone: "{milestone}"
comments: { commentsCount }
locked: { isLocked }
merged: { merged }
mergeable: { mergeable }
base_branch: "{baseBranch}"
head_branch: "{headBranch}"
updateMode: "none"
allowDelete: true
---

# {title}

**Pull Request #{number}** opened by **{author}** on {created}

{body}

## Pull Request Details

- **Status:** {status}
- **Repository:** {repository}
- **Base Branch:** `{baseBranch}`
- **Head Branch:** `{headBranch}`
- **Merged:** {merged}
- **Mergeable:** {mergeable}
  {mergedAt:- **Merged At:** {mergedAt}}

## Metadata

- **Assignees:** {assignees}
- **Labels:** {labels}
- **Comments:** {commentsCount}
- **Created:** {created}
- **Updated:** {updated}
  {closed:- **Closed:** {closed}}
  {milestone:- **Milestone:** {milestone}}

{labels_hash}

---

**[View on GitHub]({url})**

Minimal Template

A compact template using a table for details.

---
title: "{title_yaml}"
number: { number }
status: "{status}"
created: "{created}"
url: "{url}"
opened_by: "{author}"
assignees: { assignees_yaml }
labels: { labels_yaml }
updateMode: "none"
allowDelete: true
---

# {title} #{number}

> **{status}** | Created by [{author}]({url}) on {created}

## Description

{body}

## Details

| Field      | Value           |
| ---------- | --------------- |
| Status     | {status}        |
| Repository | {repository}    |
| Assignees  | {assignees}     |
| Labels     | {labels}        |
| Comments   | {commentsCount} |
| Created    | {created}       |
| Updated    | {updated}       |

## Quick Links

- [GitHub]({url})
- {commentsCount} comments
- {labels_hash}

---

_Last updated: {updated}_

Detailed Template

A comprehensive template with comments section.

---
title: "{title_yaml}"
number: { number }
status: "{status}"
type: "{type}"
repository: "{repository}"
created: "{created}"
author: "{author}"
assignees: { assignees_yaml }
labels: { labels_yaml }
updateMode: "none"
allowDelete: true
---

# {title}

**{type} #{number}** in **{repository}**

## Summary

{body}

## People

- **Author:** @{author}
- **Assignees:** {assignees}

## Classification

- **Status:** `{status}`
- **Labels:** {labels}
- **Type:** {type}

## Stats

- **Comments:** {commentsCount}
- **Created:** {created}
- **Updated:** {updated}

## Links

[View on GitHub]({url})

{comments}

---

_Last updated: {updated}_

Project Template

Template with GitHub Projects integration.

---
title: "{title_yaml}"
number: { number }
status: "{status}"
type: "{type}"
repository: "{repository}"
created: "{created}"
author: "{author}"
assignees: { assignees_yaml }
labels: { labels_yaml }
project: "{project}"
project_id: "{project_id}"
project_status: "{project_status}"
project_priority: "{project_priority}"
project_iteration: "{project_iteration}"
updateMode: "none"
allowDelete: true
---

# {title}

**{type} #{number}** in **{repository}**

{project:## Project

| Field         | Value                      |
| ------------- | -------------------------- |
| **Project**   | [{project}]({project_url}) |
| **Status**    | {project_status}           |
| **Priority**  | {project_priority}         |
| **Iteration** | {project_iteration}        |

}

## Summary

{body}

## People

- **Author:** @{author}
- **Assignees:** {assignees}

## Classification

- **Status:** `{status}`
- **Labels:** {labels}
- **Milestone:** {milestone}

## Dates

- **Created:** {created}
- **Updated:** {updated}
- **Closed:** {closed}

## Links

[View on GitHub]({url}){project: | [View in Project]({project_url})}

{comments}

---

_Last updated: {updated}_

Sub-Issues Template

Template with sub-issues support.

---
title: "{title_yaml}"
number: { number }
status: "{status}"
created: "{created}"
url: "{url}"
author: "{author}"
assignees: { assignees_yaml }
labels: { labels_yaml }
sub_issues: { sub_issues_yaml }
updateMode: "none"
allowDelete: true
---

# {title}

**Issue #{number}** opened by **{author}** on {created}

{parent_issue:> **Parent Issue:** {parent_issue_link}
}

{body}

{sub_issues:## Sub-Issues ({sub_issues_progress})

{sub_issues_list}
}

## Metadata

- **Status:** {status}
- **Repository:** {repository}
- **Assignees:** {assignees}
- **Labels:** {labels}

{labels_hash}

---

**[View on GitHub]({url})**

{% persist "notes" %}

## My Notes

{% endpersist %}

Advanced Template

A template showcasing if/elif/else blocks, value mappings, and dynamic project fields.

---
title: "{title_yaml}"
number: { number }
status: "{status}"
type: "{type}"
created: "{created}"
url: "{url}"
author: "{author}"
assignees: { assignees_yaml }
labels: { labels_yaml }
project: "{project}"
project_id: "{project_id}"
updateMode: "none"
allowDelete: true
---

# [{type|issue:Issue|pr:PR}] {title}

> {status|open:Open|closed:Closed} | **#{number}** by @{author} on {created}

{% if merged == "true" %}
**Merged** on {mergedAt} into `{baseBranch}`
{% elif status == "open" and labels contains "wip" %}
**Work in Progress** — `{headBranch}` -> `{baseBranch}`
{% elif status == "open" %}
**Open** — `{headBranch}` -> `{baseBranch}`
{% endif %}

## Description

{body}

{% if labels contains "bug" %}

> This is a **bug report**. Priority: {project_priority|High:Critical|Medium:Normal|Low:Minor|\*:Unset}
> {% elif labels contains "feature" %}
> This is a **feature request**.
> {% endif %}

{project:## Project

| Field                  | Value                      |
| ---------------------- | -------------------------- | ---------------------- | ------------------ | -------------- | -------------------- |
| **Project**            | [{project}]({project_url}) |
| **Status**             | {project_status            | Todo:Planned           | In Progress:Active | Done:Completed | \*:{project_status}} |
| **Priority**           | {project_priority          | High:Critical          | Medium:Normal      | Low:Minor      | \*:Unset}            |
| {project_iteration:    | **Iteration**              | {project_iteration}    | }                  |
| {project_field:Effort: | **Effort**                 | {project_field:Effort} | }                  |

}

## Metadata

- **Assignees:** {assignees}
- **Labels:** {labels}
  {milestone:- **Milestone:** {milestone}}

{sub_issues:## Sub-Issues ({sub_issues_progress})

{sub_issues_list}
}

{parent_issue:> **Parent Issue:** {parent_issue_link}
}

---

**[View on GitHub]({url})**

{% persist "notes" %}

## My Notes

{% endpersist %}

Tips for Using Templates

  1. Copy to your vault - Save the template as a .md file in your vault
  2. Enable in settings - Turn on "Use custom content template" and select your file
  3. Customize - Modify the template to fit your workflow
  4. Use persist blocks - Add {% persist "name" %} blocks for your own notes

See also:

Clone this wiki locally