Skip to main content

MarkdownUSM is the best way to draw a beautiful user story mapping diagram from simple markdown file.

Project description

MarkdownUSM

MIT License CircleCI codecov Supported Versions Code style: black Imports: isort

MarkdownUSM is the best way to draw a beautiful user story mapping diagram from simple markdown file.
Markdown file will be converted to XML format then you can easily use the diagram on draw.io and export in another format.

Installation

$ pip install markdownusm

Examples

Create it

Create a file sample.md with:

<!-- Comment -->

<!-- Release titles -->
- Release 1
- Release 2
- Release 3
- Release 4
- Release 5

# Activity 1
## Task 1
Story 1
--- <!-- Release separator -->
Story 2
---
Story 3

## Task 2
---
Story 4

<!-- Suffix `!` changes story postit color for warning -->
Story 5!

<!--
Multiple line comments
-->
# Activity 2
## Task 3
---
---
Story 6 &lt;br&gt; Next line
<!-- Story can change their colors by setting hex code following story title -->
Story 7 #a6dfb5

Run it

The simplest way with:

$ musm sample.md

<mxfile>
    <diagram>
        <mxGraphModel dx="661" dy="316" grid="0" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0" background="#FFFFFF">
        ...

Output XML file with:

$ musm -o sample.dio sample.md

License

This project is licensed under the terms of the MIT license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

markdownusm-0.2.0.post2.tar.gz (11.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

markdownusm-0.2.0.post2-py3-none-any.whl (13.3 kB view details)

Uploaded Python 3

File details

Details for the file markdownusm-0.2.0.post2.tar.gz.

File metadata

  • Download URL: markdownusm-0.2.0.post2.tar.gz
  • Upload date:
  • Size: 11.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.5 CPython/3.9.2 Linux/5.11.0-1027-aws

File hashes

Hashes for markdownusm-0.2.0.post2.tar.gz
Algorithm Hash digest
SHA256 4ca9e37d7f0ce5965174f716b307eaa4678873ad6b2075802c65d2f4cd67907d
MD5 13fa7ceb32976dce2a84f73d7fba69ee
BLAKE2b-256 9c59e5d0749734eb50a8e50d27c32b16f38ffda1227c43645ee1396daa5c98b1

See more details on using hashes here.

File details

Details for the file markdownusm-0.2.0.post2-py3-none-any.whl.

File metadata

  • Download URL: markdownusm-0.2.0.post2-py3-none-any.whl
  • Upload date:
  • Size: 13.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.5 CPython/3.9.2 Linux/5.11.0-1027-aws

File hashes

Hashes for markdownusm-0.2.0.post2-py3-none-any.whl
Algorithm Hash digest
SHA256 8cbf9d19e38f8b51f38e8a969b4091fc3be9deb1231945c89063fb7de343695f
MD5 8b40cd60bb6fcf8319f113bb49edd6f0
BLAKE2b-256 c66b5d52681b90189ef66ed98a00a35d46e7b697e8d55113e9ab7ae7d6a0f07f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page