Update README.md

README.md

@@ -1,5 +1,5 @@
 ---
-title: Convert To Csv
+title: Markdown To CSV Converter (for Threadscope)
 emoji: 🏢
 colorFrom: green
 colorTo: green
@@ -10,5 +10,22 @@ pinned: false
 license: mit
 short_description: 'Turn .md / .txt into csv '
 ---
+This tool converts structured chat transcripts written in markdown or plain text into a canonical turn-level CSV format suitable for analysis with Threadscope: Drift & Hold.
 
+Supported Format:
+This convertor expects transcripts that use explicit speaker markers, for example:
+You said: Hello
+ChatGPT said: Hi there
+Marker strings are configurable in the UI, but the transcript must follow a consistent "marker to content" pattern
+
+Not supported:
+Arbitarily formatted prose
+Chat logs without speaker markers
+Exported HTML/JSON without preprocessing (in process - update coming soon)
+
+Output: 
+The output CSV includes: turn, speaker, chars, words, tokens_est (lightweight est.)
+
+This tool is intended as a preprocessing step for use with Threadscope, which visualizes long-form interaction dynamics such as drift, stability, and perturbation response. 
+Files are processed in-session only and are not stored
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference