GitHub Links macro - configuration options

When you add a GitHub Links macro via the editor (or click an existing macro to edit it), a configuration panel opens on the right. The options below let you customise what is displayed.

GitHub Link (required)

The URL of the GitHub entity to display. Accepts any supported https://github.com/... or https://{your-org}.ghe.com/... URL. See Supported GitHub link types for all accepted patterns.

Show extended information

When enabled, source files and gists are displayed expanded (code visible) by default rather than collapsed. Also controls whether line-range previews are shown expanded on load.

When disabled, files are shown collapsed - click the chevron to expand inline.

URL Parameters (Beta)

Applies filters to issue lists and pull request lists. Enter a comma-separated or &-separated string of GitHub API query parameters.

Parameter	Description
`milestone`	Filter by milestone number, `*` (any milestone), or `none` (no milestone)
`assignee`	Filter by username; `none` for unassigned, `*` for any assigned
`creator`	Filter by the user who created the issue or PR
`mentioned`	Filter to issues/PRs that mention a specific user
`labels`	Comma-separated label names, e.g. `bug,ui,@high`
`sort`	Sort by `created` (default), `updated`, or `comments`
`direction`	`desc` (default) or `asc`
`since`	Only show items updated after this ISO 8601 timestamp, e.g. `2024-01-01T00:00:00Z`

Examples:

CODE

milestone=192&labels=api,debug
labels=bug&sort=updated&direction=asc
assignee=octocat&since=2024-06-01T00:00:00Z

Issue List Columns (Beta)

Applies to issue and pull request lists only. Enter a comma-separated list of column names to render the list as a table instead of the default card layout.

Reverting auto-conversion

If you paste a GitHub URL and it auto-converts but you would prefer to keep the plain URL, press Ctrl+Z (Windows) or Cmd+Z (Mac) immediately after pasting.

Updated: 12 Jun 2026