# Md To Medium > md-to-medium: Convert Markdown to Medium-publishable HTML - Skill: `manan-buddhadev/md-to-medium` (Agent Skill) - Install (CLI): `npx skillmds@latest add manan-buddhadev/md-to-medium` - Raw SKILL.md: https://api.skillmd.com/api/skills/manan-buddhadev/md-to-medium/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - Author: manan-buddhadev (https://skillmd.com/u/manan-buddhadev) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/manan-buddhadev/md-to-medium --- # md-to-medium: Convert Markdown to Medium-publishable HTML Convert a `.md` file into an `.html` file using Medium's internal `graf` CSS classes, so the content can be dragged and dropped directly into Medium's editor with formatting intact. ## How to invoke ``` /md-to-medium ``` Example: ``` /md-to-medium BLOG.md /md-to-medium /Users/manan/Vibes/website-revamp/BLOG.md ``` ## What you do 1. Read the input `.md` file 2. Convert it to Medium-compatible HTML (rules below) 3. Wrap in a minimal HTML shell with the required Medium styles 4. Write the output as `.html` in the same directory 5. Tell the user how to use it --- ## Conversion rules ### Element ordering (critical) **The `

` MUST be the first element in the body.** Medium treats the first element as the story title. Any content placed before the H1 (series callouts, blockquotes, subtitles) will be grabbed as the title instead. Rule: if the markdown has a callout/series line before the `# Title`, move it to immediately *after* the H1 in the HTML output. ### Headings ``` # Title →

Title

## Section →

Section

### Sub →

Sub

``` Strip the leading `>` blockquote series header line from its original position and place it as an italicized `

` immediately after the `

`. ### Paragraphs Each non-empty, non-code, non-heading line block becomes: ```html

text

``` ### Bold and italic (inline) ``` **text** → text *text* → text ``` ### Inline code ``` `code` → code ``` ### Links ``` [text](url) → text ``` ### Code blocks Medium has a pre/code block. Wrap fenced code blocks (``` ... ```) as: ```html 
...code content here...
``` Strip the language hint (```js, ```jsx, etc.) from the opening fence line. ### Blockquotes ``` > text →

text

``` ### Horizontal rules ``` --- → (omit entirely — Medium has no hr equivalent; just ensure a blank line between sections) ``` ### Unordered lists ``` - item →
  • item
``` Group consecutive `- ` lines into one `
    `. ### Series/callout blockquote (the `> **Label** · ...` pattern) Move after the H1. Preserve bold on the label, rest as normal paragraph text. No `` wrapper: ```html

    Building with Claude · Part 1 of an ongoing series ...

    ``` Do NOT wrap in `` — Medium renders it as italic which doesn't match the intended style. ### Do not include HTML comments Comments with `--` in their syntax (``) can leak into clipboard paste in some browsers. Omit all comments from the output HTML. --- ## Output HTML shell Wrap everything in this minimal shell so the browser renders it and the user can select-all and paste: ```html [converted content here] ``` --- ## Instructions to give the user after writing the file ``` Done. Output written to: .html To publish on Medium: 1. Open .html in your browser (double-click or `open .html`) 2. Cmd+A to select all content 3. Cmd+C to copy 4. Go to medium.com/new and paste (Cmd+V) into the editor Code blocks will need one manual step: Medium doesn't preserve 
     on paste.
For each code block, delete the pasted version, click the + button in Medium's
editor, choose "Code", and paste the raw code in.

Everything else (headings, bold, italic, links, blockquotes) should carry over automatically.
```