Markdown job description template: explain an approved role

An approved role still needs a description that an applicant can read without knowing the employer's internal discussions. This Markdown job description template puts the reason for the position beside the work it involves, the abilities it requires and the way to apply.

The description concerns an ongoing position. It doesn't argue for creating that position or define a single project with an end point. The .md file introduction explains the extension.

Describe the role after approval

Approval comes before this file. Write about the position the employer has agreed to fill, using duties and requirements that belong to that position. Unresolved questions about what the role includes need an answer before applicants are asked to consider it.

Think about the questions an applicant brings: Why does this position exist? What would I do during a working week? Which abilities does that work require? Where do I apply? The four headings below give those questions room without turning the description into an account of the employer's internal debate.

The job description template

Use this blank block for one approved position. Substitute the employer and role details for the bracketed text; put the position applicants are considering in the title.

# Job description: [role title]

Employer: [Doe employer name]

## Role purpose

[Explain why the position exists and which part of the employer's work it serves.]

## Recurring responsibilities

[Describe the duties that return during a working week, including what the person handles and who they work with.]

## Qualifications

[State the abilities required for those duties, with enough detail to explain their connection to the work.]

## How to apply

[Give the application route and describe the material applicants should provide.]

Each heading has a paragraph beneath it. The blank line between paragraphs marks a separate thought; Markdown paragraphs and blank lines explains that spacing.

A filled job description for Doe Holdings

The fictional employer Doe Holdings needs a workshop coordinator in this sample. The sessions and application route are also made up. Jane Doe is a placeholder name for the person receiving applications.

# Job description: workshop coordinator

Employer: Doe Holdings

## Role purpose

The workshop coordinator prepares the rooms and materials used in Doe Holdings' small repair workshops. The position gives session leaders a room ready for the activities they have planned.

## Recurring responsibilities

Before each session, the coordinator arranges the benches, gathers the materials requested by the session leader and places equipment in the agreed locations. Afterward, the coordinator returns equipment to storage and tells the session leader about missing or damaged items. During the week, the coordinator keeps a written record of materials used and discusses the next sessions' needs with the leaders.

## Qualifications

The role requires the ability to read equipment instructions and follow the preparation directions supplied by session leaders. Applicants need to describe missing or damaged items clearly in writing and keep accurate records of materials used. Experience arranging a shared work area is relevant because the position prepares rooms for different activities.

## How to apply

Provide a short written account of work you have done preparing a shared work area, including how you handled equipment and materials. Give your name and a way for Jane Doe to contact you. Submit the account through the workshop coordinator application page on Doe Holdings' website.

The purpose describes the room preparation that serves the workshops. The responsibilities name work before sessions, after sessions and between them. The qualifications concern those same duties, and the application paragraph identifies both the requested account and its destination. None of the fictional details should be treated as instructions for an actual employer.

Explain purpose, responsibilities, qualifications and applying

Purpose is the reason the employer needs the position. For the workshop coordinator, rooms and materials need preparation so session leaders can carry out their planned activities. A phrase such as "support the business" would leave the applicant to infer what that support involves. Naming the workshops and their preparation gives the role a defined place in the employer's work.

Recurring responsibilities describe what returns. Preparing a room before a session and putting equipment away afterward belong here because they are part of the continuing job. A one-time room renovation would describe a different kind of commitment. Use verbs that identify the work: arrange benches, gather materials, record use. An applicant can picture those actions more readily than a phrase such as "take ownership of operations."

Qualifications explain what the duties require of the person doing them. In the sample, written descriptions of damaged items call for clear writing; following equipment instructions calls for reading those instructions. Keep that relationship visible when changing the template for another position. A requirement with no connection to a described duty leaves its purpose unexplained.

How to apply closes the description with an action an applicant can take. Name the route precisely enough to distinguish it from general contact with the employer. Describe the material requested in the same paragraph. In the example, the application page is specific to the workshop coordinator, and the requested account concerns preparing a shared work area. Replace both details with the employer's actual instructions before using the file.

Give the position a descriptive file name

A file called workshop-coordinator-job-description.md identifies the role without relying on the folder around it. Keep the approved description for that position together so an applicant-facing copy doesn't inherit duties from a different job. Word separators are among the choices discussed in Markdown file naming.

Reusing the template means replacing its role details, including the application route. Merely changing the title would leave the next position with the workshop coordinator's duties and requirements. Read the finished prose as a description of that particular position before sharing it with applicants.

Where Sashmark fits

AI agents can leave you with a folder of Markdown to read. For these readers, Sashmark remains in development, with Markdown reading and editing planned in a desktop app. The approved role and its description come from the employer.