• #vscode
  • #markdownlint
  • #typescript
  • #linting
  • #code-quality

概要

VSCodeの問題タブに表示されている130件の警告・エラーを分析し、カテゴリ別に整理した。 ほとんどがMarkdownLintの警告であり、コードの動作には影響しない。

ファイル別の問題一覧

1. msft-data-202512101200.js (1件)

ルール説明
1:26ts(8010)型の注釈は、TypeScriptファイルでのみ使用できます

原因: .jsファイル内でTypeScriptの型注釈 (CompanyData[]) を使用している

修正方法:

  • ファイル拡張子を .ts に変更する
  • または型注釈を削除してプレーンJavaScriptにする

2. content-management.md (2件)

ルール説明
19:31MD026見出しの末尾に句読点 (:) がある
30:45MD026見出しの末尾に句読点 (:) がある

該当箇所:

  • ### Correct frontmatter format:
  • ### Incorrect formats that will cause errors:

修正方法: 見出しの末尾のコロン (:) を削除


3. financial-chart-requirements.md (5件)

ルール説明
9:1MD025ドキュメント内に複数のトップレベル見出し (H1) がある
26:1MD036強調(bold)を見出しの代わりに使用している
37:1MD036強調(bold)を見出しの代わりに使用している
48:1MD036強調(bold)を見出しの代わりに使用している
54:1MD036強調(bold)を見出しの代わりに使用している

原因:

  1. frontmatterのtitleとは別に、本文中に # 財務諸表チャート... というH1見出しがある
  2. **貸借対照表 (BS)** のように太字で見出し風のテキストを書いている

修正方法:

  1. 本文中のH1を削除するか、H2に変更
  2. 太字を適切な見出しレベル (#######) に変更

4. financial-data-conversion-prompt.md (46件)

MD040: コードブロックに言語が指定されていない (2件)

説明
81:1フェンスコードブロックに言語が指定されていない
91:1フェンスコードブロックに言語が指定されていない

修正方法: ``````text```plaintext に変更

MD004: 順序なしリストのスタイル (44件)

行範囲説明
178-200行アスタリスク (*) が使用されているが、プロジェクトではダッシュ (-) が期待されている

該当箇所例:

* **BS - 流動資産 (`currentAssets`):**
    * "現預金・短期投資": *Total Cash, Short Term Investments*

修正方法: *- に置換


問題カテゴリ別サマリー

カテゴリ件数重要度
MD004 (リストスタイル)44件低 (スタイルの問題のみ)
MD036 (強調を見出しに使用)4件低 (意図的な場合は無視可)
MD040 (コードブロック言語なし)2件低 (シンタックスハイライトに影響)
MD026 (見出し末尾の句読点)2件低 (スタイルの問題のみ)
MD025 (複数H1)1件中 (SEO・アクセシビリティに影響)
ts(8010) (型注釈エラー)1件高 (実行時エラーの可能性)

推奨アクション

優先度: 高

  1. msft-data-202512101200.js.ts に拡張子変更、またはcomposablesディレクトリへ移動

優先度: 中

  1. financial-chart-requirements.md の複数H1問題を修正

優先度: 低 (任意)

  1. MarkdownLintの設定ファイル (.markdownlint.json) を追加して、プロジェクト固有のルールを設定
  2. 個別ファイルのリントエラーを修正

MarkdownLint設定例

プロジェクトルートに .markdownlint.json を作成して、特定のルールを無効化できる:

{
  "MD004": false,
  "MD026": false,
  "MD036": false
}

または、特定のファイルでのみ無効化する場合は、ファイル先頭にコメントを追加:

<!-- markdownlint-disable MD004 MD036 -->

補足: 各ルールの説明

ルール説明公式ドキュメント
MD004Unordered list styleリストマーカーの統一 (- vs *)
MD025Single title/single H1ドキュメントに1つのH1のみ
MD026No trailing punctuation in heading見出し末尾の句読点禁止
MD036No emphasis as heading強調テキストを見出しとして使わない
MD040Fenced code blocks should have a languageコードブロックに言語を指定
ts(8010)Type annotations only in .ts filesJSファイルでの型注釈禁止