# Md To Blog Html

> >

- **Type:** Skill
- **Install:** `agentstack add skill-marcoax-skills-md-to-blog-html`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [marcoax](https://agentstack.voostack.com/s/marcoax)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [marcoax](https://github.com/marcoax)
- **Source:** https://github.com/marcoax/skills/tree/main/personal/md-to-blog-html

## Install

```sh
agentstack add skill-marcoax-skills-md-to-blog-html
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MD to Blog HTML

Converts a Markdown source file into the HTML format used in the `News.description` field on https://www.magutti.com/.

The canonical output format is documented by the reference at `reference/template.html` — consult it if you need to extend the converter for unsupported constructs.

## Quick start

```bash
python3 .claude/skills/md-to-blog-html/scripts/convert.py path/to/article.md
```

Writes `path/to/article.html` next to the source and copies the HTML to the macOS clipboard (ready to paste into the admin News form).

Flags:
- `--no-clipboard` — skip `pbcopy`
- `--stdout` — also print the HTML to stdout

## Source MD conventions

| Markdown | HTML output |
|---|---|
| `# Title` | **stripped** (title lives in `News.title`) |
| `## Section` | `` (between sections) + `…` |
| `### Sub` | `…` |
| `::: intro` … `:::` | `…` |
| `> line` (one or more contiguous lines) | `…` |
| ` ```…``` ` | `…` (HTML-escaped) |
| `- item` / `* item` | `…` |
| `1. item` | `…` |
| Plain paragraph | `…` |
| `**bold**` | `…` |
| `` `code` `` | `…` |
| `[txt](url)` external | `txt` |
| `[txt](url)` magutti.com or relative | `txt` |
| `—` (em-dash) | `—` |
| Orphan `&`, `` | `&`, `<`, `>` |

## Example

Input (`article.md`):

```markdown
# My Article Title

::: intro
This article explores **a real-world case** of debugging with AI.
:::

## The Problem

After migrating, this warning appeared:

`bson_append_array(): invalid array detected`

> **AI Conclusion:** None of the proposed solutions eliminated the warning.

## The Lesson

See the [StackOverflow thread](https://stackoverflow.com/questions/69670396) for details.
```

Output (`article.html`):

```html
This article explores a real-world case of debugging with AI.
The Problem
After migrating, this warning appeared:
bson_append_array(): invalid array detected
AI Conclusion: None of the proposed solutions eliminated the warning.

The Lesson
See the StackOverflow thread for details.
```

## Workflow

1. Marco writes the article in Markdown using the conventions above.
2. Run the converter — HTML lands in clipboard and on disk.
3. **Ask the user**: _"Do you also want SEO title and meta description?"_ (yes/no)
4. If **yes**: read the source MD, generate SEO fields, and print them in chat for copy-paste (see "SEO generation" below).
5. Paste the HTML into the `description` field of the News record in the admin (and the SEO fields if generated).
6. Save.

If a construct is missing, compare the actual blog output against `reference/template.html` and extend `scripts/convert.py` (the parser is line-based and easy to extend).

## SEO generation

Only after the user confirms in step 3. Produce **2–3 variants for each field** directly in chat (no file write — user copies and pastes the one they prefer):

- **SEO title** — 50–60 chars, includes the primary keyword/topic of the article.
- **SEO meta description** — 150–160 chars, summarises the article in one sentence, includes the primary keyword.

### Tone

Technical, restrained, factual. **No marketing emphasis**: avoid superlatives ("ultimate", "powerful", "amazing"), no clickbait ("you won't believe…"), no hype verbs ("master", "unlock", "transform"), no emoji, no hard CTAs. Describe what the article covers, not how exciting it is. Match the article's own register.

### Output format

```
SEO title variants:
1.    (NN chars)
2.    (NN chars)
3.    (NN chars)

SEO description variants:
1.    (NNN chars)
2.    (NNN chars)
3.    (NNN chars)
```

Each variant must include the character count to confirm it fits the range. Match the article's language — if the MD is in Italian, generate Italian SEO fields.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [marcoax](https://github.com/marcoax)
- **Source:** [marcoax/skills](https://github.com/marcoax/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-marcoax-skills-md-to-blog-html
- Seller: https://agentstack.voostack.com/s/marcoax
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.