Skip to content
PageSaver

How to Save a Webpage as Markdown (Free Ways and One Click)

To save a webpage as Markdown, you need something that reads the page, keeps the article with its headings, lists and links, and writes it out as plain text. For free, you can open the page in your browser's reading mode and paste it into Obsidian, prefix the address with an online converter such as Jina Reader, or run pandoc in a terminal. If you want a .md file in one click, the PageSaver extension we make has Save as Markdown, which is free on every plan. Here's how each one works and what it gives up.

Why save a webpage as Markdown?

A webpage is much more than the text you read. The HTML behind it carries scripts, styles, menus, cookie banners and ads. Markdown keeps only what matters for reading: # Headings, - lists, **bold**, [links](https://...) and code blocks, as plain text. Its creator, John Gruber, wrote that the overriding design goal was to "make it as readable as possible".

That makes it a good fit for where these pages usually end up:

  • Obsidian stores "your notes as Markdown-formatted plain text files in a vault", so a .md file is already a note.
  • Notion imports .md files under Settings → Import → Text & Markdown, per Notion's help page.
  • ChatGPT, Claude and other AI assistants read Markdown well. Pasting the article as Markdown instead of a raw page gives the model the structure (which line is a heading, where a list starts) without the clutter, and leaves more room in the chat for your question.
  • Docs and repos, where a small text file is easy to edit, search and track in version control.

The free way: reading mode, then paste into Obsidian

If your destination is Obsidian, you may not need a converter at all. Obsidian has a setting under Editor called Convert pasted HTML to Markdown, which, per Obsidian's settings docs, converts what you paste or drag in from web pages. The trick is to copy from a clean version of the page:

  1. Open the article and switch to reading mode. In Chrome, right-click the page and choose Open in reading mode, or press Alt+Shift+R (⌘+Option+R on a Mac), as Google's help page describes. In Safari on a Mac, click the Page menu button in the address field and choose Show Reader (Apple's guide).
  2. Select the article text and copy it.
  3. Paste it into a new note in Obsidian. With the setting on, headings, lists and links arrive as Markdown.

This costs nothing and nothing leaves your computer. The limits: reading mode only works on article-like pages (Apple notes Show Reader appears "only if the webpage has an article that Reader can show"), you copy one page at a time, and it doesn't add the source URL for you. If you paste into an app that doesn't convert HTML, you get formatted text, not Markdown.

Online URL-to-Markdown converters

A converter takes a page's address and hands back Markdown. Jina Reader is a well-known one: put https://r.jina.ai/ in front of the URL, for example https://r.jina.ai/https://example.com/article, and it returns the main content as Markdown. Basic use is free, with a limit of 20 requests a minute without an API key.

The trade-off with any online converter is that the page is fetched by their server, not your browser. Two things follow from that:

  • Privacy. The converter sees the address and the content. Jina, for example, says it caches the result for the same URL for 5 minutes and offers a "Do Not Cache or Track" option. That's fine for a public blog post, less fine for an internal wiki or a shared document link.
  • What it can see. Their server isn't signed in as you, so pages behind a login, a paywall or your company network usually come back empty or as a sign-in page.

For developers: pandoc

Pandoc is a free command-line document converter. Its manual notes that "instead of an input file, an absolute URI may be given", and pandoc will fetch it, so one command turns a page into GitHub-flavored Markdown:

pandoc -f html -t gfm --wrap=none -o article.md https://example.com/article

--wrap=none keeps each paragraph on one line, which pastes more cleanly into notes apps and chats. Use -t markdown instead if you want pandoc's own Markdown flavor.

Pandoc is excellent for scripts and batches, but it converts the HTML exactly as it gets it. It doesn't pick out the article, so navigation, footers and sidebars come along, and since it doesn't run JavaScript, pages that build their content in the browser can come back nearly empty. It also has the same sign-in limit as an online converter.

When the free options are good enough

For an occasional article going into Obsidian, reading mode plus paste is hard to beat. For a public page you want as a file, an online converter is quick. For a list of documentation pages you want to convert in a loop, pandoc is the right tool. You only need an extension if you do this often, want the file without a terminal, or want a clean article from pages where these methods drag in clutter.

Save a webpage as Markdown with PageSaver

  1. Install PageSaver for Chrome, Edge, Firefox or Safari.
  2. Open the page, click the PageSaver icon and choose Save as Markdown. You can also right-click the page and pick it from the PageSaver menu.
  3. The .md file is saved to your computer. Move it into your vault, import it into Notion, or paste it into an AI chat.

The file keeps the page's headings, lists, links, basic formatting and images. Save as Markdown is free on every plan and doesn't count toward the 15 PDF and image saves the free plan includes each month, so there's no limit on how many pages you convert.

One thing to know: PageSaver can also open the Markdown in a browser tab for you. That works by uploading a temporary copy to pagesaver.ai under a random link, which expires after an hour. If a page must never leave your machine, the reading-mode method above is the safer choice.

Save as Note, then download as Markdown or an Obsidian vault

If you're building a reading library rather than saving one file, Save as Note keeps the article in a private library in your PageSaver account. It's extracted the same way as a Reader Mode PDF: the main text, headings, code blocks, tables and images, without ads or menus. Images are saved with the note, so it stays complete even if the original page changes or is taken down. Each note gets a category and a few tags automatically.

Under PageSaver → Notes in your account you can download any note as Markdown, or select up to 100 and click Export to Obsidian. You get a zip with one folder per category and the images included. Unzip it into your vault folder and each note opens with Obsidian properties such as its title, source URL and tags. The free plan includes 5 notes in total; PageSaver Pro ($1.99 a month) and the Permanent License make notes unlimited. If you reach the limit, the notes you've saved stay available to read, download and export.

We compared this workflow with Obsidian's own clipper in Obsidian Web Clipper alternative: PageSaver vs the official.

What about converting a PDF to Markdown?

That's a different job: PixelPDF's PDF to Markdown tool converts a PDF file you already have, including scanned pages, while Save as Markdown converts the webpage you're reading. It's free, needs no account and processes the file in your browser without uploading it, with up to 50 MB per file. Choose the Compact output style if you're pasting the result into an AI chat; it trims formatting.

Which one should you use?

For an occasional article going into Obsidian, use reading mode and paste with Convert pasted HTML to Markdown turned on. For public pages and quick one-offs, an online converter like Jina Reader works, as long as you're happy for its server to see the page. For batches and scripts, use pandoc. And if you save pages to Markdown often, want a clean article file in one click, or want a library you can export to Obsidian later, use PageSaver's Save as Markdown and Save as Note.