作業の進め方
Baoyu Markdown to HTMLは、記事をインラインCSS付きのHTMLに変換し、WeChat公式アカウントでの公開フローに適した見た目を整えます。テーマとタイポグラフィの選択に加え、コードのハイライト、脚注、注意書き、図を扱います。変換したHTMLはMarkdownの元ファイルと同じ場所に保存され、既存のHTML出力がある場合はタイムスタンプ付きでバックアップされます。
完成した記事に影響する公開前の細かな設定も扱います。keep-titleを有効にしない限り、最初の見出しは既定で削除されます。外部リンクを記事末尾の引用一覧に変えるのは、明示的に依頼した場合だけです。Mermaidの図はブラウザでPNGに描画してキャッシュし、描画できない場合はテキストにフォールバックします。
想定される成果物
- テーマを適用したインラインCSS付きのHTMLファイル。
- 生成した画像や参照画像の情報。描画に成功した場合はMermaidのPNG素材も含みます。
- HTMLのパスと、作成した場合はバックアップのパスを含む構造化された結果。
ブリーフからレビューまで
- 01記事の表示方針を決める
明示されたテーマの指定とEXTEND.mdの設定を確認します。入力にCJK文字が含まれ、baoyu-format-markdownが利用できる場合は、変換前に別工程として書式を整えることを提案します。
- 02引用と見出しの扱いを選ぶ
外部リンクの引用一覧化は、依頼されない限り無効にします。先頭の見出しを記事本文に残すかどうかを決めます。
- 03本文と図を変換する
選んだ表示オプションを指定し、付属のmain.ts変換スクリプトをBun、または文書に記載されたnpx経由の代替手段で実行します。利用可能な場合、MermaidはブラウザによるPNG描画とキャッシュを使います。
- 04公開用の出力を確認する
HTMLを開いて図を確認し、結果のパスを報告します。正常に生成された画像と、フォールバックしたMermaidのマークアップを区別します。