Tango process markdown

This script is designed to post-process markdown text generated by Tango.

It removes the watermark and other unnecessary content, and downloads images so that they can be used locally.

Table of contents

• Tango process markdown
  • Table of contents
  • Minimal example
  • Installation
  • Getting started
    • 1. Get the Tango Chrome Extension
    • 2. Create a Tango account
    • 3. Start recording your step-by-step workflow
    • 4. View the results and start editing
    • 5. Copy the markdown to your clipboard
    • 6. Run the script
    • 7. View the OUTPUT and compare it to the UNPROCESSED RESULT
  • Help
  • TODO:

Minimal example

You can save the markdown text to a file and specify the file path when running the script. For example:

python3 src/tango_process_markdown/process_markdown.py --markdown-file example_unprocessed.md

Or you can copy the markdown text to your clipboard and run the script with the --clipboard flag. For example:

python3 my_script.py --clipboard

Installation

Create and activate a virtual environment and install the required packages with:

poetry install --no-root

OR

pip install .

Getting started

1. Get the Tango Chrome Extension

More details at tango.us.

2. Create a Tango account

3. Start recording your step-by-step workflow

4. View the results and start editing

Editing is optional, but allows to zoom in/out, add rectangles, add arrows or add/modify text.

Finish editing by clicking Save Workflow.

5. Copy the markdown to your clipboard

• Click on Share & Export and select Magic Copy.
• Click on Copy Markdown to copy the content to your clipboard.

6. Run the script

python3 src/tango_process_markdown/process_markdown.py --clipboard --image-dir images --header "How to use Tango like a Pro: 'Example'" --output example_processed.md

7. View the OUTPUT and compare it to the UNPROCESSED RESULT

Unprocessed image

Processed image

Help

If you have troubles, run:

python3 src/tango_process_markdown/process_markdown.py --help

TODO:

• Make async calls instead of sync
• Add unit tests
• Create GitHub Page
• Setup CI