Job description generator — a structured job posting in Markdown and HTML

How to use the job description generator

1. Fill in Job title, Company, Location and Employment type (full-time, part-time, contract, internship or temporary).
2. Enter the Pay range (recommended) as you want it to read, for example “₹6,00,000 – ₹8,00,000 a year”.
3. Write About the role in a few sentences.
4. List Responsibilities, Requirements, Nice to have and Benefits, one per line.
5. Explain How to apply, then copy the Markdown or check the Preview.

What it does and when to use it

Applicants scan a job advert for the same few answers: what the job is, where, what it pays, what they would do, and whether they qualify. This tool puts those answers in a predictable order, so nothing important ends up buried.

The output starts with the job title as a heading, then one summary line — company · location · type · pay — followed by About the role, Responsibilities, Requirements, Nice to have, Benefits and How to apply. Use it for a new role, to tidy an old advert, or to keep several adverts consistent.

When you have picked someone, the offer letter generator drafts the offer from the same role, location and pay details. The appointment letter can reuse the responsibilities as key duties. To promote the opening, an internal memo tells current staff before it goes public.

How it works

Each list field is split into lines; blank lines are dropped and leading bullets are removed. The summary line joins company, location and employment type with “ · “ and adds the pay range only if given. When the pay field is empty, a reminder appears above the output. The preview is a simple HTML page with the same sections. Everything is built in your browser.

Worked examples

The sample support role. “Customer support specialist” at Ledgerly gives the summary line **Ledgerly** · Remote (India, IST hours) · Full-time · ₹6,00,000 – ₹8,00,000 a year, then all six sections with four responsibilities, three requirements, two nice-to-haves and three benefits.

A short part-time advert. Title “Weekend barista”, Bluebird Cafe, San Francisco, part-time, no pay range and no “about” text. The summary reads **Bluebird Cafe** · San Francisco, CA · Part-time; the sections are Responsibilities, Requirements, Benefits and How to apply; and the pay-range reminder appears.

Limits and tips

• Describe outcomes, not just tasks: “answer customer questions within our response targets” says more than “answer questions”.
• Keep requirements short. Long lists put off qualified people.
• Use plain, inclusive language and avoid requirements that are not needed for the job, such as an age range.
• The tool does not check employment law; review the advert against the rules where you hire.