Guides
Markdown Resumes

Markdown resumes

Write your resume in Markdown, choose a theme, and download styled HTML or save a PDF through your browser’s print dialog.

Open the public resume builder

Open the public builder and create or import your resume:

To sync your resume across devices or collaborate on it, save it to your mdedit.ai account from the builder.

Set the resume render profile

A resume uses the resume render profile and the mdedit block in front matter:

---
mdedit:
  renderProfile: resume
---

For reproducible output, also add print settings:

---
mdedit:
  renderProfile: resume
  styles:
    # Built-in renderer preset: use one of the two options below
    theme: classic
  page:
    size: letter
    margin: 0.5in
---

Theme, size, and margin choices

  • Theme maps to the builder UI names:
    • classic → Classic
    • compact → Compact
    • resume-template-1 is the older id for Classic. Existing documents keep rendering, and new documents should use classic.
  • Page size supports letter or a4.
  • Margin accepts values like 0.35in, 0.5in, 0.7in, or 12mm.

Portable resume editing

Keep the body in standard Markdown sections so the same file can move across editors.

  • Use plain links for assets when possible.
  • If you need exact visual polish, prefer inline CSS over external dependencies.
  • Keep all resume text in the Markdown file so it remains readable if external resources fail to load.

Optional custom CSS

Inline CSS is self-contained only when it does not reference external resources:

---
mdedit:
  renderProfile: resume
  styles:
    cssInline: |
      #resume-preview h2 { letter-spacing: 0.04em; text-transform: uppercase; }
---

You can also load local or remote CSS files with explicit consent:

---
mdedit:
  renderProfile: resume
  styles:
    cssFiles:
      - assets/resume.css
    cssUrls:
      - https://cdn.example.com/resume.css
    allowRemoteCss: true
---

Behavior details:

  • cssFiles can reference uploaded document assets such as assets/resume.css after the resume is saved to mdedit.ai. The public builder does not import a sibling CSS file when you open a local Markdown file.
  • cssUrls works with remote URLs only when allowRemoteCss: true.
  • allowRemoteCss does not inspect or block URLs inside cssInline. Avoid @import, remote fonts, url(...), and other external references when the resume must remain private and work offline.
  • If allowRemoteCss is not enabled, remote CSS is skipped and the resume remains readable.
  • If remote CSS fails to load because of offline mode, CORS, or network errors, the resume remains usable.

Export your resume

For resume documents, the supported outputs in this workflow are:

  • Markdown download (local source, portable).
  • Styled HTML download.
  • Print / Save as PDF (via browser print dialog).

Do not expect direct server-generated DOCX, server-side PDF, or other export formats for the resume renderer.

Choose an output or save the document:

  • Use Print / Save as PDF when you need a final resume artifact.
  • For collaboration, comments, and synced storage, save to mdedit from the builder.

Save locally or to your account

  • In the public builder, drafts are stored locally in your browser and no login is required for Markdown + styled HTML + Print / Save as PDF.
  • After saving to mdedit.ai, you can organize the resume in folders, share it, and sync it across devices. Markdown, styled HTML, and print exports keep the resume layout.

Privacy and recovery expectations:

  • Local-mode drafting keeps your resume source in-browser.
  • Saving to mdedit uploads the document and ties it to your account.
  • Remote CSS requests can reveal third-party request metadata (for example, IP address and User-Agent) and should be used only with trusted hosts.

Print / Save as PDF steps

  1. Click Print / Save as PDF in the resume builder.
  2. Use your browser print dialog to choose “Save as PDF” (or print to a device).
  3. If a print result is blank or incomplete, follow the troubleshooting route below first:

Related resume docs

Guides overviewOverview

Last reviewed