Turning rough notes into Markdown and Mermaid
Notes copied from a chat, an email or a meeting rarely arrive in the format documentation needs. Lists have no markers, steps have no structure, code has no fence. Reformatting them by hand is tedious.
Paste a short snippet and pick a format: tidy it up, or turn it into a Markdown paragraph, quote, list, key-value table, fenced code block, or a Mermaid flowchart where each line becomes a step.
How to use it
- Paste the snippet into the input box.
- Choose a mode: Cleanup, Markdown, Quote, List, Table, Code or Mermaid.
- Set the options for the mode, such as ordered or unordered lists, or the language for a code fence.
- Copy the output into your README, wiki page or issue.
Example: three steps as a flowchart
Write draft Review Publish
flowchart TD n1["Write draft"] n2["Review"] n3["Publish"] n1 --> n2 n2 --> n3
Each line becomes a box and consecutive boxes are joined with arrows, top to bottom.
The modes
Cleanup trims stray spaces and collapses runs of blank lines. Markdown keeps paragraphs as they are. Quote prefixes every line with >. List turns each line into a bullet, or a numbered item when Ordered is chosen; Markdown renumbers 1. 1. 1. automatically. Table reads lines of the form key: value into a two-column table. Code wraps the text in a fenced block with an optional language name for syntax highlighting.
Mermaid diagrams in documentation
Mermaid describes diagrams as text, so they live in the same file as the documentation and change with it under version control. GitHub, GitLab, Notion, Obsidian and many documentation generators render code blocks marked mermaid as diagrams. Put the output inside a fence that starts with ```mermaid and the platform draws the flowchart. Edit the arrows by hand for branches, for example n2 --> n1 for a review that sends the draft back.
Short snippets, not whole documents
The tool is built for a few lines at a time: a list from a meeting, a config fragment, a sequence of steps. For whole documents, a Markdown editor with a live preview, such as the Markdown preview tool, is the better fit.
Questions
Why are all numbered items 1.?
Markdown numbers ordered lists itself, so writing 1. on every line is valid and makes reordering easy.
Can the flowchart branch?
The generated chart is a straight sequence. Add extra arrows by hand; Mermaid's syntax is easy to edit.
Is my text uploaded?
No. Formatting happens in your browser.