Sub Issues

Sub-Issues

GitHub Sub-Issues allow you to break down large issues into smaller, trackable pieces. This plugin supports fetching and displaying sub-issues in your notes.

Enabling Sub-Issues

1. Go to plugin settings
2. Expand your repository settings
3. Enable "Include sub-issues"

Template Variables

Variable	Description	Example
{sub_issues_count}	Total count	5
{sub_issues_open}	Open count	3
{sub_issues_closed}	Closed count	2
{sub_issues_progress}	Progress	2 of 5
{sub_issues_list}	Formatted list	See below
{sub_issues_simple_list}	Simple list	See below
{sub_issues_yaml}	YAML array	[1, 2, 3]
{sub_issues_numbers}	Numbers only	#1, #2, #3

Display Formats

{sub_issues_list} - With Status Icons

- <span class="github-issues-sub-issue-closed">●</span> [[Issue - 140|#140 Completed Feature]]
- <span class="github-issues-sub-issue-open">●</span> [#141 Pending Feature](https://github.com/...)

Features:

• Green dot (●) for open issues
• Red dot (●) for closed issues
• Internal Obsidian link if issue exists in vault
• External GitHub link if issue doesn't exist

{sub_issues_simple_list} - Without Icons

- [[Issue - 140|#140 Completed Feature]]
- [#141 Pending Feature](https://github.com/...)

Parent Issues

If an issue is a sub-issue of another, you can display the parent:

Variable	Description
{parent_issue}	Parent title
{parent_issue_number}	Parent number
{parent_issue_url}	Parent URL
{parent_issue_link}	Markdown link
{parent_issue_state}	Parent state

Template Example

---
title: "{title_yaml}"
number: {number}
sub_issues: {sub_issues_yaml}
---

# {title}

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

{body}

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

{sub_issues_list}
}

Styling

The status icons use CSS classes that you can customize:

:root {
  --github-issues-sub-issue-open-color: #22c55e;   /* Green */
  --github-issues-sub-issue-closed-color: #ef4444; /* Red */
}

.github-issues-sub-issue-open {
  color: var(--github-issues-sub-issue-open-color);
}

.github-issues-sub-issue-closed {
  color: var(--github-issues-sub-issue-closed-color);
}

Add custom CSS via a CSS snippet in Obsidian to override the default colors.

Intelligent Links

The plugin automatically creates:

• Internal links ([[filename|#123 Title]]) when the sub-issue file exists in your vault
• External links ([#123 Title](url)) when the sub-issue hasn't been synced yet

This happens automatically based on your filename template settings.