Help and user guide

Everything you need to open a document, understand the preview, copy formatted content, export to Word or PDF, and recover from common problems.

Last updated: November 15, 2026

Start with the tool, not the manual

The fastest way to learn the workflow is to open the Markdown viewer and edit the sample document. Come back here when you need limits, export details or troubleshooting.

Quick start

The same document stays available while you move between the viewer and the export pages.
  1. Open the viewer

    The homepage contains the live editor and preview. The Word and PDF routes add an upload panel for a direct file-to-document workflow.

  2. Add content

    Paste Markdown into the editor, choose Open, or drag a .md or .markdown file onto the workspace. The Sample button restores the example document.

  3. Preview and export

    Use the preview to check formatting, then copy the source or formatted HTML, download a DOCX, or print the preview to PDF.

Opening local Markdown files

Files are read by the browser and are not uploaded.
  • Accepted extensions are .md and .markdown, in any letter case. The browser-provided MIME type is treated as a hint, not proof.
  • The maximum file size is 150,000 bytes. Empty or unreadable files produce an error and do not replace the current document.
  • Drag and drop is optional. The Open button uses the same file input and is the keyboard-accessible path.
  • The filename appears in the workspace only. It is not sent to the server or saved in browser storage.
  • A document longer than 120,000 characters cannot be previewed or exported, even if its file size is under the byte limit.

Using the editor and preview

The workspace is split into source and preview panels on wide screens, and stacked on narrow screens.
  • Live preview: edits are rendered as you type. Large documents use a short debounce before rendering.
  • Sample: loads the built-in example so you can test formatting.
  • Clear: empties the editor and removes the current document from the workspace.
  • Sync scroll: keeps the source and preview panels at roughly the same position.
  • Wrap: wraps long source lines instead of showing a horizontal scrollbar.
  • Word count, character count and an estimated reading time are shown above the workspace.

Copying Markdown or formatted output

Two copy actions serve different purposes.

Copy MD

Copies the original Markdown source. Use this to move the document into another editor without losing syntax.

Copy Format

Copies the sanitized formatted HTML and a plain-text fallback. Use this for a rich-text destination such as a CMS, email composer or document editor.

Clipboard access depends on browser permissions. If either action is blocked, the status message explains what happened. Copying the formatted preview also works with a normal text selection and the browser's own copy command.

Exporting to Word

The DOCX route creates a standard Word file in the browser.
  1. 1. Add Markdown or keep the document you already opened.
  2. 2. Check the preview, especially tables, code and equations.
  3. 3. Select Download Word document and open the saved DOCX.

Headings, paragraphs, emphasis, links, lists, blockquotes, code, tables, task lists and supported equations are converted. Remote images are not embedded; the export leaves a labeled placeholder with the alt text. Word layout, fonts and pagination can differ from the browser preview, so review the file before sharing it.

The source is capped at 120,000 characters, equations are capped at 500, and the output must stay under 25 MB. See the Markdown to Word page for the full workflow and export notes.

Creating a PDF

PDF output uses the browser print dialog rather than a PDF library.
  1. 1. Add or open the Markdown document.
  2. 2. Select Download PDF to open the print dialog.
  3. 3. Choose Save as PDF, check the paper size and margins, then save.

Only the formatted preview is printed; the editor, toolbar and site navigation are hidden. The print stylesheet uses light colors and 18 mm margins, but your browser's print settings control the final page size, headers, footers and page breaks. The print action waits up to about ten seconds for remote images to decode before opening the dialog.

See the Markdown to PDF page for print settings that affect the result.

Supported Markdown and formatting

The preview uses CommonMark, GitHub-Flavored Markdown and KaTeX.
  • CommonMark headings, emphasis, links, images, lists, quotes, code and horizontal rules.
  • GFM tables, task lists, strikethrough, autolinks and footnotes.
  • Inline and display math with dollar delimiters; LaTeX-style backslash delimiters are normalized.
  • Raw HTML is removed before rendering. Links are limited to http, https and mailto; image sources to http and https.
  • Mermaid diagrams and syntax highlighting are not supported. Code is displayed as plain monospaced text.

The Markdown cheat sheet shows each syntax pattern with a rendered example.

Troubleshooting

Common messages and what to do next.
The file picker rejects my document
Only .md and .markdown files are accepted. Rename a text file with the correct extension if it really contains Markdown, or paste its contents into the editor. Empty files are rejected as well.
The file is too large
Local files can be up to 150,000 bytes, and the preview and export pipeline is limited to 120,000 characters. Split long documents into smaller sections and convert them separately. A file that is under the byte limit can still exceed the character limit.
The preview is not updating
Very large documents are rendered on a short delay to keep typing responsive. Wait for the Updating preview indicator to finish. If the document exceeds 120,000 characters, shorten it; the error message explains the limit.
The DOCX download button is disabled
The button is unavailable while the preview is still updating or when the document is empty. Wait for the status to settle, then try again. If export fails, the message identifies the likely cause, such as too many equations or a file above the 25 MB output limit.
My equations are not editable in Word
Supported LaTeX becomes an editable Word equation. Malformed or unsupported syntax is replaced with labeled LaTeX source and a warning. Check the equation after opening the file, especially uncommon commands and aligned environments.
The PDF layout is different from the screen
The PDF is produced by your browser's print dialog. Page size, margins, headers, footers and page breaks come from those print settings, not from the site. Adjust them before saving, or use the Word export when you need finer layout control.
Copy did not work
Clipboard access can be blocked by browser permissions or by the page losing focus. The status message reports the failure; when copying Markdown fails, the editor selects the source so you can copy it manually.
An image is missing from the PDF or DOCX
PDF printing waits briefly for remote images, then warns if any fail. DOCX export never embeds remote images; it adds a placeholder with the alt text. Check that the image URL is reachable and uses http or https.

Keyboard access and accessibility

The workspace is usable without drag and drop.
  • The page starts with a Skip to content link for keyboard users.
  • Use the Open button to reach the file picker without dragging a file. The file input has an accessible name.
  • The Markdown source has a programmatic label, and the preview is a labeled region.
  • Wide tables in the preview become focusable scroll regions so they can be read without widening the page.
  • Theme choice is stored locally and can be changed with the header toggle.

Privacy at a glance

The short version, with the full policy linked below.

Documents stay in the browser tab

Markdown and local files are not uploaded for rendering or conversion. The theme preference is stored in local storage. The hosting infrastructure may process standard request data, Vercel Web Analytics records aggregated page views, and remote images are loaded from their original hosts. Read the Privacy Policy for the details.

Keep exploring