Skip to content

gh-cli extension to create markdown links and issue references

Notifications You must be signed in to change notification settings

zerowidth/gh-md

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gh-md: markdown link and issue reference generation

This GitHub CLI extension generates markdown links from input URLs or references.

This isn't particularly useful by itself, but combine it with tools like Alfred snippet triggers, Raycast scripts, or Obsidian templates, you can automate these links for insertion into your markdown documents.

Installation

gh extension install zerowidth/gh-md

Usage

gh md --help for full details.

gh md link

Generates a markdown link from an input URL or issue/pr/discussion reference.

Basic example:

$ gh md link https://github.com/cli/cli/pull/123
[cli/cli#123: Tweak flags language](https://github.com/cli/cli/pull/123)

Skip title lookup:

$ gh md link --simple https://github.com/cli/cli/pull/123
[cli/cli#123](https://github.com/cli/cli/pull/123)

Create a link from an issue reference:

$ gh md link cli/cli#123
[cli/cli#123: Tweak flags language](https://github.com/cli/cli/pull/123)

gh md ref

Generates an issue/pr/discussion reference from an input URL or reference.

$ gh md ref https://github.com/cli/cli/pull/123
cli/cli#123

gh md title

Looks up the title of the given URL or reference:

$ gh md title cli/cli#123
Tweak flags language

The title can be sanitized for use as a path, stripping :, /, and a few other characters.

gh md url

Generates the URL from the given issue reference or markdown link.

$ gh md url cli/cli#123
https://github.com/cli/cli/pull/123

Using gh-md in Obsidian

gh-md was built in part to be used in user-defined functions in the Templater plugin.

Markdown links

  • define a markdownLink user function as /path/to/gh md link -n "$input"
  • copy a GitHub URL to your clipboard
  • use it in a template: <% tp.user.markdownLink({input: (await tp.system.clipboard())}) %>

Sanitized titles

The sanitized issue title can be used for filenames. In a templater template for creating a document for an issue from the clipboard:

  • Define a markdownTitle user function as /path/to/gh md title -n --sanitize "$input".

  • Use the title to rename a new file from that template:

    <%- await tp.file.rename("Issue - " + tp.date.now("YYYY-MM") + " - " + (await tp.user.markdownTitle({input: (await tp.system.clipboard())}))) -%>
    

Auth issues

If you're using a recent version of the GitHub CLI that uses the system keychain to store credentials, these helper functions may not work. If so, you can configure the PATH in the user functions. This assumes you've installed the GH CLI with homebrew:

  • PATH=$PATH:/opt/homebrew/bin /opt/homebrew/bin/gh md link -n "$input"
  • PATH=$PATH:/opt/homebrew/bin /opt/homebrew/bin/gh md title -n --sanitize "$input"

Using gh-md with Espanso

An espanso config for generating links and references from the clipboard:

matches:
  - trigger: "//md"
    replace: "{{output}}"
    vars:
      - name: clipboard
        type: clipboard
      - name: output
        type: shell
        params:
          cmd: "gh md link {{clipboard}}"
  - trigger: "//ml"
    replace: "{{output}}"
    vars:
      - name: clipboard
        type: clipboard
      - name: output
        type: shell
        params:
          cmd: "gh md link --simple {{clipboard}}"
  - trigger: "//ir"
    replace: "{{output}}"
    vars:
      - name: clipboard
        type: clipboard
      - name: output
        type: shell
        params:
          cmd: "gh md ref {{clipboard}}"

About

gh-cli extension to create markdown links and issue references

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages