概要
VSCodeの問題タブに表示されている130件の警告・エラーを分析し、カテゴリ別に整理した。 ほとんどがMarkdownLintの警告であり、コードの動作には影響しない。
ファイル別の問題一覧
1. msft-data-202512101200.js (1件)
| 行 | ルール | 説明 |
|---|---|---|
| 1:26 | ts(8010) | 型の注釈は、TypeScriptファイルでのみ使用できます |
原因: .jsファイル内でTypeScriptの型注釈 (CompanyData[]) を使用している
修正方法:
- ファイル拡張子を
.tsに変更する - または型注釈を削除してプレーンJavaScriptにする
2. content-management.md (2件)
| 行 | ルール | 説明 |
|---|---|---|
| 19:31 | MD026 | 見出しの末尾に句読点 (:) がある |
| 30:45 | MD026 | 見出しの末尾に句読点 (:) がある |
該当箇所:
### Correct frontmatter format:### Incorrect formats that will cause errors:
修正方法: 見出しの末尾のコロン (:) を削除
3. financial-chart-requirements.md (5件)
| 行 | ルール | 説明 |
|---|---|---|
| 9:1 | MD025 | ドキュメント内に複数のトップレベル見出し (H1) がある |
| 26:1 | MD036 | 強調(bold)を見出しの代わりに使用している |
| 37:1 | MD036 | 強調(bold)を見出しの代わりに使用している |
| 48:1 | MD036 | 強調(bold)を見出しの代わりに使用している |
| 54:1 | MD036 | 強調(bold)を見出しの代わりに使用している |
原因:
- frontmatterのtitleとは別に、本文中に
# 財務諸表チャート...というH1見出しがある **貸借対照表 (BS)**のように太字で見出し風のテキストを書いている
修正方法:
- 本文中のH1を削除するか、H2に変更
- 太字を適切な見出しレベル (
###や####) に変更
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件 | 高 (実行時エラーの可能性) |
推奨アクション
優先度: 高
- msft-data-202512101200.js →
.tsに拡張子変更、またはcomposablesディレクトリへ移動
優先度: 中
- financial-chart-requirements.md の複数H1問題を修正
優先度: 低 (任意)
- MarkdownLintの設定ファイル (
.markdownlint.json) を追加して、プロジェクト固有のルールを設定 - 個別ファイルのリントエラーを修正
MarkdownLint設定例
プロジェクトルートに .markdownlint.json を作成して、特定のルールを無効化できる:
{
"MD004": false,
"MD026": false,
"MD036": false
}
または、特定のファイルでのみ無効化する場合は、ファイル先頭にコメントを追加:
<!-- markdownlint-disable MD004 MD036 -->
補足: 各ルールの説明
| ルール | 説明 | 公式ドキュメント |
|---|---|---|
| MD004 | Unordered list style | リストマーカーの統一 (- vs *) |
| MD025 | Single title/single H1 | ドキュメントに1つのH1のみ |
| MD026 | No trailing punctuation in heading | 見出し末尾の句読点禁止 |
| MD036 | No emphasis as heading | 強調テキストを見出しとして使わない |
| MD040 | Fenced code blocks should have a language | コードブロックに言語を指定 |
| ts(8010) | Type annotations only in .ts files | JSファイルでの型注釈禁止 |