README.md

metadata

title: Markdown To CSV Converter (for Threadscope)
emoji: 🏢
colorFrom: green
colorTo: green
sdk: gradio
sdk_version: 6.3.0
app_file: app.py
pinned: false
license: mit
short_description: 'Turn .md / .txt into csv '

What this tool does

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 transcript format

This converter 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 → content” pattern.

Not supported

• Arbitrarily formatted prose
• Chat logs without explicit speaker markers
• Exported HTML or JSON without preprocessing

Output

The generated CSV includes the following columns:

• turn
• speaker
• chars
• words
• tokens_est (lightweight estimate)

How this fits into the Threadbourne lab

This tool is intended as a preprocessing step for use with Threadscope: Drift & Hold, which visualizes long-form interaction dynamics such as drift, stability, and perturbation response.

Privacy

Files are processed in-session only and are not stored.

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference