borghei/Claude-Skills / markdown-html/md-document
md-document
VerifiedConvert authored markdown into a polished self-contained HTML document with a table of contents, numbered figures and tables, cross-references, footnotes, and print-ready CSS. Use when publishing a report, whitepaper, or memo.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.7 KB |
| assets/document_outline_template.md | markdown | 2.4 KB |
| assets/document_theme.css | other | 6.7 KB |
| assets/sample_document.md | markdown | 3.0 KB |
| assets/sample_print_profile.json | config | 929 B |
| references/markdown-conventions.md | markdown | 10.9 KB |
| references/print-and-pdf-production.md | markdown | 10.5 KB |
| scripts/crossref_auditor.py | script | 9.8 KB |
| scripts/md_render.py | script | 13.2 KB |
| scripts/md_to_html.py | script | 6.3 KB |
| scripts/print_profile.py | script | 9.7 KB |
assets/document_outline_template.md
View on GitHub---
title: <Document title>
author: <Team or person>
date: <YYYY-MM-DD>
status: draft
audience: <exec / working team / external>
---
# <Document title>
<Two to four sentences: what question this document answers, what it covers, and
what it concludes. A reader who stops here should still know the recommendation.>
[TOC]
## Context {#sec:context}
<What is true today and why it matters now. Numbers, not adjectives. This section
earns the reader's attention — if the situation is not clearly a problem, the
rest of the document has no purpose.>
{#fig:context}
## Analysis {#sec:analysis}
<The evidence. One subsection per line of argument.>
### <First line of argument>
<Prose. Reference evidence by number — [@fig:context], [@tbl:options] — never
"the chart below".>
| Option | <Dimension> | <Dimension> | <Dimension> |
|--------|-------------|-------------|-------------|
| A | | | |
| B | | | |
| C | | | |
Table: <What the table shows and how to read it> {#tbl:options}
### <Second line of argument>
<Prose. Put the caveat that would break the sentence in a footnote.[^caveat]>
## Recommendation {#sec:recommendation}
**<State the recommendation in bold, as a directive, in one sentence.>**
<Why this option and not the others. Reference [@tbl:options] explicitly. Name
the option you rejected and why — a recommendation that does not say what it
rejected reads as though only one option was considered.>
### What this costs
<The honest downside. Every recommendation has one. Omitting it does not make it
disappear; it makes the reader distrust the rest.>
### What happens next
1. <Action> — <owner> — <date>
2. <Action> — <owner> — <date>
## Open questions {#sec:open}
- <Question that would change the recommendation if answered differently>
- <Question that does not block the decision but needs an owner>
---
[^caveat]: <The qualification, the exception, or the assumption that a careful
reader would otherwise challenge.>
<!--
Before publishing:
1. crossref_auditor.py — labels, references, alt text, heading hierarchy
2. md_to_html.py — convert; the gate fails on unresolved references
3. print_profile.py — if this will be printed or exported to PDF
4. Proof every page of the PDF, not just the first three
-->
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |