Loading…

概要 オンラインTOMLフォーマッター

乱雑な`pyproject.toml`、`Cargo.toml`、`poetry`設定でお困りですか？TOMLを貼り付けるかファイルをドロップすると、当フォーマッターが空白を正規化し、配列とインラインテーブルを整理し、セクションの間隔を一貫して保ちます。Python、Rust、Go、静的サイトジェネレーター、およびTOMLを設定に使用するあらゆるプロジェクトに最適です。

TOMLフォーマッターの主な機能

  • **ワンクリック整形** TOML設定ファイルとスニペット用
  • **設定可能なインデントサイズ** *インデントサイズ*スライダーで1〜8スペースから選択
  • **インデントスタイル切り替え** – スペースまたはタブを選択
  • **折り返し/行の長さ**制御 – 長い配列とインラインテーブルを選択した列幅内に収める
  • `.toml`ファイルをサポート（`pyproject.toml`、`Cargo.toml`、`Pipfile.toml`、`poetry.toml`など）
  • PrettierベースのTOMLパーサー – 日付、配列、ネストされたテーブル、インラインテーブルを理解
  • 安定した冪等なフォーマット – 同じファイルで再実行してもフォーマットのずれが発生しません
  • 整形された出力をワンクリックでコピー – エディターやコミットにすぐに使用可能

🛠️ オンラインでTOMLファイルをフォーマットする方法 for toml-formatter

1

1. TOMLを貼り付けまたはアップロード

📥 TOMLをエディターに貼り付けるか、`pyproject.toml`や`Cargo.toml`などの`.toml`ファイルをドラッグ＆ドロップします。このツールは内容をTOMLとして解析し、一般的なINI/JSONではありません。

2

2. インデントと折り返し設定を選択

⚙️ **インデントサイズ**スライダーを使用してインデントレベルごとのスペース数を選択し、プロジェクトがタブを好む場合は**インデントスタイル**をタブに切り替えます。**折り返し/行の長さ**を調整して、長い配列やインラインテーブルを折り返すタイミングを制御します（`0`に設定すると事実上折り返しを無効にできます）。

3

3. 「フォーマット」をクリック

🚀 **フォーマット**ボタンを押します。フォーマッターは配列を再配置し、`=`とカンマの周りのスペースを整理し、テーブルのスペースを正規化し、データを保持しながら一貫した改行を適用します。

4

4. 確認、コピー、または保存

🔍 元のTOMLと整形されたTOMLを比較します。満足したら、結果をエディターにコピーするか、プロジェクト内で新しい`.toml`ファイルとして保存します。

技術仕様

サポートされているTOML機能

このフォーマッターは実世界のプロジェクト設定用に構築されており、現代のTOML構造を理解します。

機能サポート例/備考
テーブルとサブテーブル✅ 完全[tool.poetry]、[project]、[database.replica]
配列✅ 完全インライン配列とテーブルの配列
インラインテーブル✅ 完全対応servers = { alpha = "10.0.0.1", beta = "10.0.0.2" }
日付と時刻✅ 完全対応2025-09-23T10:20:30Z およびローカル日付形式
コメント✅ 保持# コメントは説明対象の設定近くに残る
複数行文字列✅ 完全対応長文ブロック用の三重引用符TOML文字列

書式設定オプション（ツール制御にマッピング）

これらのオプションはUIで直接公開され、基盤のPrettier TOMLプラグインに接続されています：

オプションUIコントロール範囲 / 値デフォルト
インデントサイズインデントサイズスライダー1〜8スペース2スペース
インデントスタイルインデントスタイル選択スペース / タブスペース
行の長さ折り返し / 行の長さ0〜120カラム（0 = 実質的に折り返しなし）80カラム
行末行末（内部）LF / CRLFブラウザ出力ではLF

入力と制限

本ツールは、アプリケーションレポで一般的な小〜中規模TOMLファイルに最適化されています。

パラメータ値 / 動作備考
ファイル拡張子.toml任意のTOMLベースの設定ファイル
MIMEタイプapplication/toml, text/x-tomlドロップゾーンでのファイル検出に使用
最大ファイルサイズ約5 MB大きなファイルは処理が遅くなる可能性があり、CIでの処理が推奨されます
最大文字数約2,000,000ブラウザのフリーズを防ぐためのフォーマッター実行時のハードリミット

検証とエラー処理

ファイルが有効なTOMLでない場合（例: `=`の欠落や引用符の不一致）、フォーマッターは通常、フォーマットされた出力ではなく読み取り可能なエラーを返します。指定された行を修正してフォーマッターを再度実行してください。

TOMLフォーマットのコマンドライン代替手段

結果が気に入り、CIやpre-commitフックで同じスタイルを使用したいですか？以下はCLI対応のオプションです：

クロスプラットフォーム（Node.js / Prettier）

PrettierとTOMLプラグインをインストール

npm install --save-dev prettier prettier-plugin-toml

プロジェクトにPrettierとTOMLパーサーを追加します。

PrettierでTOMLファイルをフォーマット

npx prettier --parser toml --write pyproject.toml

PrettierのTOMLルールを使用して`pyproject.toml`をその場で書き換えます。

Linux / macOS / Windows（Taplo CLI）

Taploを使用してTOMLをフォーマット

taplo fmt pyproject.toml

TOMLファイル用のもう1つの人気CLIフォーマッターです。

CIでのフォーマットをチェック

taplo fmt --check .

TOMLファイルが適切にフォーマットされていない場合、ビルドを失敗させます。

このオンラインツールで素早い編集と実験を行い、CIパイプラインではPrettierまたはTaploで同じスタイルを強制してください。

TOMLフォーマッターの一般的な使用例

Pythonパッケージング（`pyproject.toml`）

Pythonプロジェクトのメタデータとツール設定をクリーンでレビューしやすく保ちます。

  • `[project]`、`[tool.poetry]`、`[tool.black]`セクションを整列。
  • 依存関係配列とバージョン指定子を正規化。
  • プルリクエストでの設定差分を読みやすくします。
[project]
name = "my-app"
version = "0.1.0"

[tool.black]
line-length = 88
include = "\.(py|pyi)$"

Rustプロジェクト（`Cargo.toml`）

ワークスペースとマイクロサービス全体でRustパッケージマニフェストを整理します。

  • `[dependencies]`と`[dev-dependencies]`をソートし、一貫した間隔で維持します。
  • 複雑な機能フラグに使用されるインラインテーブルを正規化します。
  • ワークスペース内の複数のクレート間でフォーマットを標準化します。
[package]
name = "my-crate"
version = "0.1.0"
edition = "2021"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

静的サイト＆ツール（Hugo、Zolaなど）

静的サイトジェネレータや様々なツールで使用されるTOMLをクリーンにします。

  • Hugoや他の静的サイトジェネレータ向けに`config.toml`をフォーマットします。
  • 多言語設定ブロックを読みやすく維持します。
  • メニュー項目や分類などの長いリストを正規化します。

❓ Frequently Asked Questions

❓TOMLフォーマッターとは何ですか？

TOMLフォーマッターは、TOMLファイルを一貫したスタイルに従うように自動的に再構築します：インデントを修正し、配列とインラインテーブルを整列させ、`=`やカンマの周りのスペースを正規化し、データを保持しながら読みやすくレビューしやすくします。

📏インデントサイズとスタイルはどのように選ぶべきですか？

チームに好みがない場合、**2スペース**が良いデフォルトです。リポジトリで既に使用されているスタイルに合わせてください：ファイルが主にスペースでインデントされている場合はスペースを使い続け、タブがチーム標準の場合は**インデントスタイル**をタブに切り替えて、新しい変更が既存のコードと揃うようにします。

🧪フォーマッターはTOML構文を検証しますか？

基盤となるパーサーは無効なTOML（例：`=`の欠落や引用符の不一致）を拒否します。その場合、ツールはフォーマットされた出力の代わりにエラーメッセージを表示するので、問題を修正して再試行できます。

🔁フォーマッターの実行は設定の動作を変更しますか？

フォーマッターは**意味を保存する**ように設計されています：キー、値、テーブル構造ではなく、空白とレイアウトのみを変更します。元のファイルが有効なTOMLである限り、設定の意味は同じままです。

🔒機密設定ファイルをフォーマットしても安全ですか？

他のオンラインツールと同様に、本番シークレットなどの極めて機密性の高い情報を貼り付けるのは避けてください。高度に機密性の高い設定については、プライベートな開発環境内でローカルのTOMLフォーマッター（PrettierやTaploなど）を使用してください。

Pro Tips

Best Practice

メインブランチに適切にフォーマットされた`pyproject.toml`または`Cargo.toml`を保持し、CIでPrettierやTaploを使用して同じスタイルを強制します。

Best Practice

大きな依存関係や設定の変更をコミットする前にTOMLをフォーマットすると、Git差分が**実際の変更**に焦点を当て、空白のノイズではなくなります。

Best Practice

設定をリファクタリングする際は、まずファイルをフォーマットし、コミットしてから値を変更します。これにより、実際に何が変更されたかをレビューしやすくなります。

Best Practice

すべてのTOMLファイルで同じ**インデントサイズ**と**折り返し長さ**を使用して、プロジェクト間のナビゲーションとコードレビューを一貫して感じられるようにしましょう。

Additional Resources

TOML v1.0.0仕様
Documentation
Prettier TOMLプラグイン
Documentation
Taplo – TOMLツールキット
Documentation

Other Tools