Skip to content

thisizasif/ReadmeStudio

Repository files navigation

Readme Studio

Status License Stars Forks Issues Website

Readme Studio is a free, browser‑based README.md builder for GitHub projects. It focuses on clean, best‑practice sections and produces a polished Markdown file with badges and optional sections based on what you actually fill in.

Live Website

https://thisizasif.github.io/ReadmeStudio/

What This Tool Does

  • Generates a production‑ready README.md from a simple form
  • Shows a live preview and a separate Markdown view
  • Builds badges automatically (repo, license, status, etc.)
  • Includes or omits sections based on your input (no empty headings)
  • Provides a FAQ builder with multiple Q/A entries
  • Supports tech‑stack badge selection

Key Features

  • Live preview (rendered output)
  • Markdown view with one‑click copy
  • Tech stack badge picker
  • Screenshot URLs section
  • FAQ builder (add as many Q/A items as needed)
  • Optional social badges section
  • Table of Contents auto‑generated when enough sections exist

How to Use

  1. Open the site.
  2. Fill in the fields that apply to your project.
  3. Click “Open Preview” to see the rendered README.
  4. Switch to “Show Markdown” and click “Copy Markdown”.
  5. Paste into your repository as README.md.

Output Behavior (Important)

  • Only sections with content are rendered.
  • Links in Demo/Repository/Contributing are rendered as badges.
  • The Table of Contents appears automatically when there are enough sections.

Tech Stack

HTML5 CSS3 JavaScript Marked DOMPurify

Project Structure

  • index.html – UI layout and metadata
  • style.css – visual theme and layout
  • script.js – form logic, Markdown generation, preview rendering
  • og-image.html / generate-images.py – social image assets

Local Development

This is a static site. You can open index.html directly in a browser or serve it with any static server.

License

MIT License

Author

thisizasif – https://github.com/thisizasif