Requestを作る」があります。Request(以下プルリク)の説明文はMarkdown記法をサポートしているので、箇条書きやWeb上にあるドキュメントへリンクなどを気軽に書くことができます。ところで、プルリクの説明文やいわゆるREADME.mdのようなMarkdownで書かれた内容は直接GitHub上で表示されるのではなく1、別途HTMLに変換されて表示されます。プルリク作成の画面ではMarkdownの編集モードとPreviewモードが別タブで用意されているのですが、本ブログ内でたびたび登場するVSCodeなどのエディタではMarkdown形式の内容とその描画結果を横に並べて確認しながら編集が可能なので、プレビューモードと編集モードを都度マウスで切り替えることが手間に感じることがあります。プルリクをローカルで作るそこで、プルリクの説明文をローカル環境で作成することにしました。等適当に命名したファイルに説明文を書き、都度プレビューするのみです。使うと以下のコマンドでブラウザなしにプルリクが作成できるので重宝しています。Markdownもプレビューしたい多くの場合前述の方法で問題ないのですが、不満に感じることが出てきました。Markdownがプレビューできない場合があることです。Markdownと呼ばれるMarkdownの方言に従い、いくつかの拡張構文があります。基本的な内容はこちらにまとまっていて、私が個人的によく使うのは「プルリクエストの参照」です。他にもこちらで触れられている「タスクリスト」(チェックボックス)をよく使いますが、いずれも少なくとも202301末時点のVSCodeの標準のMarkdownプレビュー機能ではサポートされておらず、プレビューできません。1番のプルリクへのリンクになりますが、(当然ではありますが)VSCodeではリンクにはならずそのまま出力されます。API(20221128現在)を見つけました。text.とあるように、Markdown形式の内容を入力することで対応するHTMLファイルを返してくれます。CLIを使うと認証情報の入力を省略して実行できます。Markdownとして処理することを指定します。対象とするリポジトリを指定します。記載したときに、どのリポジトリのプルリクか、というコンテキストを付与するものです。directory;作業ディレクトリのリポジトリの情報をもとに自動で適切な値を使ってくれます。ように都度明示するより汎用的ですね。