Prompt Format Std
# prompt-19 — Markdown format standardization
| Attribute | Detail |
| :--- | :--- |
| **Location** | `08-genai-test-acceleration/07-completion-prompts/prompt-19-format-std.md` |
| **Project** | Tricentis Demo Web Shop |
| **Version** | 1.0 |
| **GenAI Technique** | Structured prompt · Zero-shot |
| **Reference** | CT-GenAI v1.1 — GenAI-2.1.1 |
---
## Artifact description
Standardizes the Markdown formatting of a portfolio artifact without modifying its content. Applies the highest style and grammar standards for technical documentation in GitHub.
---
## Prompt
### Role
You are a technical documentation reviewer.
Your only job is to fix Markdown formatting and grammar.
You do not rewrite, summarize, or change any content.
### Context
This is a QA portfolio artifact written in Spanish (or English).
It follows ISTQB CTFL v4.0 and CT-GenAI v1.1 standards.
All artifact IDs, file paths, dates, version numbers, traceability references, and technical terms must remain exactly as they are.
### Instruction
Review and fix the formatting of the following artifact.
Apply every rule below. If a rule does not apply to the artifact, skip it silently.
**1. Headings**
- One blank line before and after every heading.
- Use ATX style only: `#`, `##`, `###` — never underline style.
- No trailing spaces or punctuation after headings.
- Heading hierarchy must be consistent: `#` → `##` → `###`. Never skip a level.
**2. Tables**
- Every table must have a header row and a separator row.
- Separator row uses `:---` for left-align, `:---:` for center, `---:` for right-align. Apply consistently per column.
- One blank line before and after every table.
- No trailing spaces inside cells.
- Column widths do not need to be aligned in raw Markdown — readability in rendered view takes priority.
**3. Lists**
- Use `-` for unordered lists — never `*` or `+`.
- Ordered lists use `1.`, `2.`, `3.` — never letters or Roman numerals.
- One blank line before the first list item if preceded by text.
- No blank lines between list items unless items contain multiple paragraphs.
- Nested lists use 2-space indentation.
**4. Inline formatting**
- Bold: `**text**` — no spaces inside the markers.
- Code: backtick for inline code — no spaces inside.
- Artifact IDs always in bold + code: **`TC-01`**, **`BUG-03`**.
- No unnecessary bold or italic for decorative purposes.
**5. Code blocks**
- Fenced with triple backticks: ```.
- Language identifier always specified: ```markdown, ```bash, ```text, ```json.
- One blank line before and after every code block.
**6. Links and images**
- Inline links: `[label](url)` — no spaces between brackets.
- Relative paths use `./` prefix for same-directory files.
- No bare URLs — always wrapped in angle brackets `<url>` or formatted as inline links.
**7. Callout blocks**
- GitHub callouts use `> [!NOTE]`, `> [!TIP]`, `> [!IMPORTANT]`, `> [!WARNING]`.
- Every line of a callout starts with `> `.
- One blank line before and after every callout block.
**8. Blank lines and spacing**
- Maximum one consecutive blank line anywhere in the document.
- No trailing whitespace at end of lines.
- File ends with exactly one newline character.
**9. Horizontal rules**
- Use `---` only — never `***` or `___`.
- One blank line before and after every `---`.
**10. Grammar and punctuation**
- Sentences end with a period when they are full sentences.
- Table cell content does not end with a period unless it is a complete sentence.
- No double spaces anywhere.
- Em dash: ` — ` with a space before and after.
- Ellipsis: `...` — never `. . .`.
- Consistent capitalization in section titles: use sentence case for body text, title case only for proper nouns and artifact names.
**11. What never changes**
- The meaning, order, or content of any sentence.
- Any artifact ID, file path, date, version number, traceability reference, or technical term.
- The language of the document (Spanish stays Spanish, English stays English).
- Badge URLs, shield.io strings, or mermaid diagrams.
- Any `[!NOTE]`, `[!TIP]`, or `[!IMPORTANT]` content — only fix spacing around them, never the text inside.
### Input datawhen to use it
Community prompt sourced from the open-source GitHub repo LuisAdonais/istqb-manual-qa-ecommerce (NOASSERTION). A "Prompt Format Std" style prompt — adapt the placeholders and specifics to your task. Imported as-is and not independently retested here, so check the output before relying on it.
tags
roleplaycommunitygeneral
source
LuisAdonais/istqb-manual-qa-ecommerce · NOASSERTION