C# でMarkdownドキュメントを比較

Wordize for .NET は、MD ファイルのプログラム的な比較と、ファイル間の差分検出のためのプロフェッショナルソリューションです。Comparerクラスにより、C# 開発者は二つの MD ドキュメントのコンテンツ差分を必要な詳細レベルで特定し、比較結果を出力ドキュメントに保存できます。ドキュメント間の差分は、作成者と変更時刻情報とともに、最初の MD ドキュメントのリビジョンとして表示されます。

主な機能：

精密な差分検出 - Comparer.Compare()メソッドは、挿入、削除、Markdownマークアップの修正を含む、特定された変更を含む結果ドキュメントを作成します
CompareOptionsクラスによる MD 比較パラメータの柔軟な設定：変更追跡の詳細化（文字単位または単語単位）、テキスト移動の検出、大文字・小文字変更の無視、テーブル、ドキュメントフィールド、脚注、コメント、テキストボックス、フォーマットの無視
結果のグラフィック形式へのエクスポート機能 - Comparer.CompareToImages()メソッドは、比較結果を画像配列として返します
ファイルとStreamオブジェクトの両方での作業サポート
Comparer.ComparerContextとメソッドチェーンによる MD 比較操作実行のためのFluent APIサポート、C# コードに明瞭性を追加

使用シナリオ：

技術文書のバージョン管理 - READMEファイル、APIドキュメント、開発者ガイドのMarkdown形式での異なるバージョン間の変更追跡
ドキュメントでの協働作業 - 開発チームメンバーによるプロジェクトドキュメントの変更分析
ブログと記事の変更監査 - Web公開用にMarkdownで書かれた記事のドラフトと最終版の比較
編集コンテンツレビュー - 品質管理とスタイル要件への適合のための編集修正前後の MD ドキュメントバージョンの比較

このページに提示されたインタラクティブオンラインデモで MD ドキュメントのプログラム的比較機能をテストしてください。二つの MD ファイルをアップロードし、比較操作を実行し、マークアップとコンテンツで特定された差分とともに結果をダウンロードしてください。提供された C# コード断片は、あなたの .NET プロジェクトですぐに使用できます。

コードを実行

最初のドキュメントをアップロード

二番目のドキュメントをアップロード

リストから出力フォーマットを選択

using Wordize.Comparing;

Comparer.Compare("Input1.md", "Input2.md",
    "Output.md", "Author Name", DateTime.Now);

                            using Wordize.Comparing;

Comparer.Compare("Input1.md", "Input2.md",
    "Output.md", "Author Name", DateTime.Now);

                            using Wordize.Comparing;
using Wordize.Saving;

var imageStreams = Comparer.CompareToImages("Input1.md", "Input2.md", 
    new ImageSaveOptions(SaveFormat.Md), "Author Name", DateTime.Now);

foreach (var (stream, page) in imageStreams.Select((s, i) => (s, i)))
{
    using var _ = stream;
    stream.Position = 0;
    
    using var file = File.Create($"Output_{page + 1}.md");
    stream.CopyTo(file);
}
            

				    コードを実行
			    

C#でMDを比較する方法

Wordize SDKを.NETプロジェクトに接続してください。
Comparer.Compare()メソッドを呼び出し、二つのMDドキュメント、比較出力を保存する結果ファイル、メタデータ（作成者と日付）を引数として指定してください。
MDドキュメント比較結果を取得してください。