自作のマークダウン CMS を一週間ほど自分だけで使ってみて、まあまあな感じだったので一般公開します。
"My info" を略して "Mynfo" と名付けています。ソースコードは GitHub に公開してます。自分でも使ってみたい場合はフォークして使ってください（フォーク先は public でも private でも構いませんが、public の場合は GitHub 上のコンテンツが公開される点に注意してください）：
https://github.com/dotnsf/mynfo
また、サンプルとして（皆さんには編集権限はありませんが）この公開ソースコードで作ったコンテンツサービスを以下で公開しています：
https://mynfo.herokuapp.com/
実際にみなさんもこの仕組みを使ってコンテンツサービスを公開する場合、必須ではありませんが heroku のアカウントを所有している場合は自分の GitHub リポジトリにコンテンツをコミットすることで CI/CD で最新コンテンツに更新できる仕組みがあります（しかもこの方法だとコンテンツの更新履歴が Git 側に残る、という大きなメリットがあります）。この機能を使う想定で設定方法を README.md 内で解説しているので、heroku アカウントと併せて使うことを推奨します（試しにローカルホストで動かしてみる、程度であれば不要です）。
【ローカルホストで動かしてみる】
試しにローカルホストで動かすには Node.js 環境が必要です。事前にセットアップしておきましょう。
フォークしたコードを git clone して、npm install してから node app で実行します：
デフォルトでは 8080 番ポートで HTTP リクエストを待ち受けます。ウェブブラウザで localhost:8080 にアクセスします。以下のような画面が表示されれば起動成功です（初期状態では README.md にシンボリックリンクした md/index.md の内容が（マークダウンが HTML に変換されて）表示されています。英語で一通りの使い方が紹介されています）：
（↑皆さんが使うときには md/index.md と README.md とのシンボリックリンクは切っちゃって構いません）
画面右上のハンバーガーメニューをクリックすると、リポジトリ内の md/ フォルダ以下を対象フォルダとするファイル選択画面が表示されます（デフォルト状態では md/ フォルダ以下に about_markdown.md, index.md, sample.md の３つのマークダウンファイルが存在しており、それらが（.md 拡張子が省略された形で）一覧表示されています：
試しに一番上の about_markdown を選択すると md/about_markdown.md ファイルの内容が HTML に変換されて表示されます：
また初期画面で表示されている README.md の最初にも記述していますが、実行時の環境変数や settings.js ファイル内で値を指定することで挙動を変えることができます。例えばサービスを不特定多数の人に公開するのではなく、一部の人向けにクローズドな形で公開したい場合は環境変数 BASIC_USERNAME と BASIC_PASSWORD を指定して実行することでベーシック認証が有効になり、正しい ユーザー ID とパスワードを入力しないとコンテンツは見ることができません。
見栄えに関しては環境変数 CONTENTS_TITLE でサイトの題名（デフォルト値は "Mynfo"）を、BOOTSTRAP_THEME で Bootstrap のテーマ（デフォルト値は "warning"）を指定できます。例えば前者を ".NSF Mynfo"、後者を "info" に指定するとこのような見栄えになります：
基本機能としてはこのような感じです。プロジェクトフォルダ内の md/ フォルダ内にあるマークダウン（.md）ファイルを参照することができる、というものです。ただこのサービス自体にはマークダウンの編集機能はありません。このままサーバー上で（普通に）公開する場合は、別途 md/ フォルダ内のマークダウンファイルを編集する仕組み（サーバー上で直接編集するなど）が必要です。
動くか動かないかでは動くのですが、個人的にはこのような使い方はあまり想定していません。あくまで後述のような、GitHub リポジトリと連携する使い方を想定して開発しています。
【heroku のデプロイパイプラインを使う】
サーバー上の .md ファイルを直接編集するような使い方は本来想定したものではありません。この Mynfo の最大の特徴は以下のような使い方ができることです：
・ローカルホストで（好きなマークダウンエディタで）.md ファイルを編集して、
・Github にコミット＆プッシュすると、
・デプロイパイプラインによって、サービス側のコンテンツも更新される
この流れを heroku を使って実現する方法も README.md に（英語で）記載していますが、このブログでは同じ内容を日本語で紹介します。
まず heroku のアカウントを作成します。heroku には複数種類のアカウントが存在していますが、ただ動かすだけであれば（容量や可用性などを考慮せずに、小規模１インスタンスだけで動かす前提であれば）無料プランで構いません。
※なお heroku の無料プランで作成するアプリは 30 分間アクセスがないと止まってしまい、次にアクセスした時に再起動してからアプリが稼働します（この場合、アプリ画面が表示されるまで再起動のぶん少し時間がかかります）。24 時間ずっと稼働状態をキープしたい場合は有料プランで運用することを推奨します。
そして heroku にログインし、画面右上から New - Create new app を選択します：
次にアプリケーション名（下図では "mynfo"）を入力し、サービスを作成する地域（下図では "United States"）を指定します。そして次に（Create app ではなく） Add to pipeline を選択します：
Choose a pipeline と書かれた箇所をクリックし、Create new pipeline を選択します：
そして作成するパイプラインの名称（下図では "mynfo-pipeline"）を適当に入力し、デプロイ先のステージを指定します。例えば「一度ステージング環境にデプロイし、動作確認ができたらプロダクション環境へデプロイ」するようなケースも想定できますが、今回はそのままプロダクション環境へデプロイするシンプルな例を紹介します。というわけでここではパイプラインのデプロイ先として production を直接指定します。最後に Create app をクリックします：
これでパイプラインそのものは作成されましたが、まだ GitHub リポジトリとの連携ができていません。このまま作業を続けます。
デプロイ方法として GitHub 連携をしたいので Deployment Method に GitHub を選択します：
そして対象となる GitHub リポジトリ（クローンしたリポジトリ）を指定します。Connect to GitHub 欄で自分の GitHub アイコンを選択し、対象リポジトリ名（そのままであれば "mynfo"）を入力して Search します：
すると該当の GitHub リポジトリが見つかるので、横にある Connect ボタンをクリックします：
これで GitHub との接続ができました。最後に自動デプロイのための対象ブランチを指定するので、このまま続けます：
Automatic Deploy 欄でパイプラインが参照する GitHub リポジトリのブランチを指定します。特にブランチを作っていない場合は main だけが選択できるので、この main が選択された状態で Enable Automatic Deploy ボタンをクリックします（別途ブランチを作成して、main 以外のブランチを指定することも可能です）：
これでフォークした GitHub リポジトリの main ブランチに変更がコミットされると、パイプラインが動いて最新コードが heroku 上のアプリケーションとして https://（アプリ名）.herokuapp.com/ という URL で動き出すようになります：
また、この時点で作成したパイプラインの状態を参照すると、GitHub リポジトリの指定したブランチを接続されて、更新時の自動デプロイが有効になっている旨を確認できます：
この状態で試しに１ファイルを追加して動作確認しています。ローカルホスト上で１ファイル追加して git コマンドでコミットしてもいいのですが、今回は GitHub のウェブ画面を使って追加コミットする例を紹介します。
まずはウェブブラウザで該当 GitHub リポジトリのページ（フォークしたリポジトリのページ）を開き、md フォルダを選択します：
ここからファイルを指定して編集することもできますが、今回は新しいファイルを１つ追加することにします。画面右の Add file ボタンをクリックして、表示されるメニューから Create new file を指定します：
GitHub リポジトリに直接ファイルを追加する編集画面が表示されるので、試しにファイル名を test.md 、ファイルの中身には "# テスト" と見出し行だけ入力します：
画面を下にスクロールすると、GitHub に直接コミットする情報を指定する箇所が現れます。ここでコミットコメント（下図では "md/test.md added."）、を指定し、"Commit directly to the main branch" が選択された状態のまま Commit new file ボタンをクリックします：
これで GitHub リポジトリにマークダウンファイルが１つ追加でコミットされました（ローカルホストでも編集する場合はこの状態を git pull して、ローカルホスト側も更新しておいてください）。
そして指定ブランチがコミットされたことで、heroku に作成したパイプラインが自動実行されます。パイプライン実行そのものも数秒で終わってしまいますが、下図はビルド中（デプロイ完了前）のパイプライン画面です。アプリケーションのビルド中である旨が表示されています：
デプロイが完了するとこのような画面になり、ここから最新の（追加コードが反映された状態の）アプリケーションを開くこともできます：
確認のため、アプリケーションを開きます（Open app と書かれたボタンで開きます）。そして画面右上のハンバーガーメニューをクリックします：
すると存在していなかった test.md というファイルが確認できます。試しにこのファイルを選択します：
作成した通りの内容（ "# テスト"）であることが確認できます：
このように GitHub リポジトリと連携して、ローカルホストや GitHub 画面でマークダウンファイルを追加・更新・削除してサーバーにコミットすると、自動で公開アプリにも反映される仕組みができました。こうしておくことでローカルホストでは VSCode など好きなマークダウンエディタで編集することができるようになって、後は編集後にコミット＆プッシュすればアプリにも反映される、という仕組みになりました。
冒頭でも書きましたが、このコンテンツサービスそのものはベーシック認証を有効にすることで一部の人だけに公開することもできます。ただそれとは別に GitHub リポジトリを公開するか／しないかを考慮する点があることに注意してください。基本的にベーシック認証をかけるサービスであれば、フォーク先の GitHub リポジトリも private 扱いにするべきだと思っています。
また環境変数 GITHUB_REPO_URL （リポジトリURL）と GITHUB_BRANCH （ブランチ名）を指定して実行すると、コンテンツの各画面内に GitHub のコンテンツメニューが追加され、各ページやファイル選択画面内から GitHub の対象ページ画面に移動したり、直接編集ページに移動したり、フォルダに新しいファイルを追加することも可能です（編集は編集権限を持っているユーザーのみ使えます）：
この GitHub と連携した使い方はちょっとクセがあるので、普段 Git を使っていない人からすると（編集画面も無いし）むしろ不便に感じるかもしれません。が、Git やマークダウンに慣れたエンジニアであれば、むしろこの使い方で（慣れたマークダウンエディタとも連携して）コンテンツを更新情報まで含めて管理ができることになって便利だと思っていて、このようなサービスを作ってみました。
ちなみに、このアプリでブログ的な使い方をする場合は、コンテンツのファイル名を日付（例えば 20220219.md）にして、環境変数 REVERSE_FILES の値を 1 にして実行することで（新しい日付のファイルがリストの上にくるように並ぶので）使いやすいのでは、と思っています。
Git やマークダウンをバッチリ使っている自分からはなかなか便利に使えているサービスなので、同様の属性を持った人に使ってみていただきたいです。
なお現時点では GitHub と heroku のパイプラインを使う想定で README.md を記述していますが、GitLab など GitHub 以外の Git システムや、GitHub Actions など heroku パイプライン以外の自動デプロイ化の仕組みを使って運用することもできると考えています。ぜひ多くのパターンで挑戦していただきたいです。
"My info" を略して "Mynfo" と名付けています。ソースコードは GitHub に公開してます。自分でも使ってみたい場合はフォークして使ってください（フォーク先は public でも private でも構いませんが、public の場合は GitHub 上のコンテンツが公開される点に注意してください）：
https://github.com/dotnsf/mynfo
また、サンプルとして（皆さんには編集権限はありませんが）この公開ソースコードで作ったコンテンツサービスを以下で公開しています：
https://mynfo.herokuapp.com/
実際にみなさんもこの仕組みを使ってコンテンツサービスを公開する場合、必須ではありませんが heroku のアカウントを所有している場合は自分の GitHub リポジトリにコンテンツをコミットすることで CI/CD で最新コンテンツに更新できる仕組みがあります（しかもこの方法だとコンテンツの更新履歴が Git 側に残る、という大きなメリットがあります）。この機能を使う想定で設定方法を README.md 内で解説しているので、heroku アカウントと併せて使うことを推奨します（試しにローカルホストで動かしてみる、程度であれば不要です）。
【ローカルホストで動かしてみる】
試しにローカルホストで動かすには Node.js 環境が必要です。事前にセットアップしておきましょう。
フォークしたコードを git clone して、npm install してから node app で実行します：
$ git clone https://github.com/dotnsf/mynfo.git （"dotnsf" 部分はあなたの Github アカウント名に読み替えてください）
$ cd mynfo
$ npm install
$ node app
デフォルトでは 8080 番ポートで HTTP リクエストを待ち受けます。ウェブブラウザで localhost:8080 にアクセスします。以下のような画面が表示されれば起動成功です（初期状態では README.md にシンボリックリンクした md/index.md の内容が（マークダウンが HTML に変換されて）表示されています。英語で一通りの使い方が紹介されています）：
（↑皆さんが使うときには md/index.md と README.md とのシンボリックリンクは切っちゃって構いません）
画面右上のハンバーガーメニューをクリックすると、リポジトリ内の md/ フォルダ以下を対象フォルダとするファイル選択画面が表示されます（デフォルト状態では md/ フォルダ以下に about_markdown.md, index.md, sample.md の３つのマークダウンファイルが存在しており、それらが（.md 拡張子が省略された形で）一覧表示されています：
試しに一番上の about_markdown を選択すると md/about_markdown.md ファイルの内容が HTML に変換されて表示されます：
また初期画面で表示されている README.md の最初にも記述していますが、実行時の環境変数や settings.js ファイル内で値を指定することで挙動を変えることができます。例えばサービスを不特定多数の人に公開するのではなく、一部の人向けにクローズドな形で公開したい場合は環境変数 BASIC_USERNAME と BASIC_PASSWORD を指定して実行することでベーシック認証が有効になり、正しい ユーザー ID とパスワードを入力しないとコンテンツは見ることができません。
見栄えに関しては環境変数 CONTENTS_TITLE でサイトの題名（デフォルト値は "Mynfo"）を、BOOTSTRAP_THEME で Bootstrap のテーマ（デフォルト値は "warning"）を指定できます。例えば前者を ".NSF Mynfo"、後者を "info" に指定するとこのような見栄えになります：
基本機能としてはこのような感じです。プロジェクトフォルダ内の md/ フォルダ内にあるマークダウン（.md）ファイルを参照することができる、というものです。ただこのサービス自体にはマークダウンの編集機能はありません。このままサーバー上で（普通に）公開する場合は、別途 md/ フォルダ内のマークダウンファイルを編集する仕組み（サーバー上で直接編集するなど）が必要です。
動くか動かないかでは動くのですが、個人的にはこのような使い方はあまり想定していません。あくまで後述のような、GitHub リポジトリと連携する使い方を想定して開発しています。
【heroku のデプロイパイプラインを使う】
サーバー上の .md ファイルを直接編集するような使い方は本来想定したものではありません。この Mynfo の最大の特徴は以下のような使い方ができることです：
・ローカルホストで（好きなマークダウンエディタで）.md ファイルを編集して、
・Github にコミット＆プッシュすると、
・デプロイパイプラインによって、サービス側のコンテンツも更新される
この流れを heroku を使って実現する方法も README.md に（英語で）記載していますが、このブログでは同じ内容を日本語で紹介します。
まず heroku のアカウントを作成します。heroku には複数種類のアカウントが存在していますが、ただ動かすだけであれば（容量や可用性などを考慮せずに、小規模１インスタンスだけで動かす前提であれば）無料プランで構いません。
※なお heroku の無料プランで作成するアプリは 30 分間アクセスがないと止まってしまい、次にアクセスした時に再起動してからアプリが稼働します（この場合、アプリ画面が表示されるまで再起動のぶん少し時間がかかります）。24 時間ずっと稼働状態をキープしたい場合は有料プランで運用することを推奨します。
そして heroku にログインし、画面右上から New - Create new app を選択します：
次にアプリケーション名（下図では "mynfo"）を入力し、サービスを作成する地域（下図では "United States"）を指定します。そして次に（Create app ではなく） Add to pipeline を選択します：
Choose a pipeline と書かれた箇所をクリックし、Create new pipeline を選択します：
そして作成するパイプラインの名称（下図では "mynfo-pipeline"）を適当に入力し、デプロイ先のステージを指定します。例えば「一度ステージング環境にデプロイし、動作確認ができたらプロダクション環境へデプロイ」するようなケースも想定できますが、今回はそのままプロダクション環境へデプロイするシンプルな例を紹介します。というわけでここではパイプラインのデプロイ先として production を直接指定します。最後に Create app をクリックします：
これでパイプラインそのものは作成されましたが、まだ GitHub リポジトリとの連携ができていません。このまま作業を続けます。
デプロイ方法として GitHub 連携をしたいので Deployment Method に GitHub を選択します：
そして対象となる GitHub リポジトリ（クローンしたリポジトリ）を指定します。Connect to GitHub 欄で自分の GitHub アイコンを選択し、対象リポジトリ名（そのままであれば "mynfo"）を入力して Search します：
すると該当の GitHub リポジトリが見つかるので、横にある Connect ボタンをクリックします：
これで GitHub との接続ができました。最後に自動デプロイのための対象ブランチを指定するので、このまま続けます：
Automatic Deploy 欄でパイプラインが参照する GitHub リポジトリのブランチを指定します。特にブランチを作っていない場合は main だけが選択できるので、この main が選択された状態で Enable Automatic Deploy ボタンをクリックします（別途ブランチを作成して、main 以外のブランチを指定することも可能です）：
これでフォークした GitHub リポジトリの main ブランチに変更がコミットされると、パイプラインが動いて最新コードが heroku 上のアプリケーションとして https://（アプリ名）.herokuapp.com/ という URL で動き出すようになります：
また、この時点で作成したパイプラインの状態を参照すると、GitHub リポジトリの指定したブランチを接続されて、更新時の自動デプロイが有効になっている旨を確認できます：
この状態で試しに１ファイルを追加して動作確認しています。ローカルホスト上で１ファイル追加して git コマンドでコミットしてもいいのですが、今回は GitHub のウェブ画面を使って追加コミットする例を紹介します。
まずはウェブブラウザで該当 GitHub リポジトリのページ（フォークしたリポジトリのページ）を開き、md フォルダを選択します：
ここからファイルを指定して編集することもできますが、今回は新しいファイルを１つ追加することにします。画面右の Add file ボタンをクリックして、表示されるメニューから Create new file を指定します：
GitHub リポジトリに直接ファイルを追加する編集画面が表示されるので、試しにファイル名を test.md 、ファイルの中身には "# テスト" と見出し行だけ入力します：
画面を下にスクロールすると、GitHub に直接コミットする情報を指定する箇所が現れます。ここでコミットコメント（下図では "md/test.md added."）、を指定し、"Commit directly to the main branch" が選択された状態のまま Commit new file ボタンをクリックします：
これで GitHub リポジトリにマークダウンファイルが１つ追加でコミットされました（ローカルホストでも編集する場合はこの状態を git pull して、ローカルホスト側も更新しておいてください）。
そして指定ブランチがコミットされたことで、heroku に作成したパイプラインが自動実行されます。パイプライン実行そのものも数秒で終わってしまいますが、下図はビルド中（デプロイ完了前）のパイプライン画面です。アプリケーションのビルド中である旨が表示されています：
デプロイが完了するとこのような画面になり、ここから最新の（追加コードが反映された状態の）アプリケーションを開くこともできます：
確認のため、アプリケーションを開きます（Open app と書かれたボタンで開きます）。そして画面右上のハンバーガーメニューをクリックします：
すると存在していなかった test.md というファイルが確認できます。試しにこのファイルを選択します：
作成した通りの内容（ "# テスト"）であることが確認できます：
このように GitHub リポジトリと連携して、ローカルホストや GitHub 画面でマークダウンファイルを追加・更新・削除してサーバーにコミットすると、自動で公開アプリにも反映される仕組みができました。こうしておくことでローカルホストでは VSCode など好きなマークダウンエディタで編集することができるようになって、後は編集後にコミット＆プッシュすればアプリにも反映される、という仕組みになりました。
冒頭でも書きましたが、このコンテンツサービスそのものはベーシック認証を有効にすることで一部の人だけに公開することもできます。ただそれとは別に GitHub リポジトリを公開するか／しないかを考慮する点があることに注意してください。基本的にベーシック認証をかけるサービスであれば、フォーク先の GitHub リポジトリも private 扱いにするべきだと思っています。
また環境変数 GITHUB_REPO_URL （リポジトリURL）と GITHUB_BRANCH （ブランチ名）を指定して実行すると、コンテンツの各画面内に GitHub のコンテンツメニューが追加され、各ページやファイル選択画面内から GitHub の対象ページ画面に移動したり、直接編集ページに移動したり、フォルダに新しいファイルを追加することも可能です（編集は編集権限を持っているユーザーのみ使えます）：
この GitHub と連携した使い方はちょっとクセがあるので、普段 Git を使っていない人からすると（編集画面も無いし）むしろ不便に感じるかもしれません。が、Git やマークダウンに慣れたエンジニアであれば、むしろこの使い方で（慣れたマークダウンエディタとも連携して）コンテンツを更新情報まで含めて管理ができることになって便利だと思っていて、このようなサービスを作ってみました。
ちなみに、このアプリでブログ的な使い方をする場合は、コンテンツのファイル名を日付（例えば 20220219.md）にして、環境変数 REVERSE_FILES の値を 1 にして実行することで（新しい日付のファイルがリストの上にくるように並ぶので）使いやすいのでは、と思っています。
Git やマークダウンをバッチリ使っている自分からはなかなか便利に使えているサービスなので、同様の属性を持った人に使ってみていただきたいです。
なお現時点では GitHub と heroku のパイプラインを使う想定で README.md を記述していますが、GitLab など GitHub 以外の Git システムや、GitHub Actions など heroku パイプライン以外の自動デプロイ化の仕組みを使って運用することもできると考えています。ぜひ多くのパターンで挑戦していただきたいです。
コメント