Convert HTML to Markdown for Obsidian

Obsidian stores notes as plain Markdown files. When you find something on the web you want to save — an article, documentation page, tutorial — the challenge is getting that content into clean Markdown without losing the structure. Copy-pasting from a browser gives you unformatted text. Saving the HTML gives you a mess.

The workflow: grab the HTML source, convert to Markdown in one step, paste into your vault.

Why Convert HTML to Markdown for Obsidian?

Obsidian is a Markdown-first tool. Its notes are .md files on your filesystem, which means:

• Content needs to be in Markdown to render correctly with headings, bold, lists, and links
• Raw HTML can be pasted into Obsidian notes, but it shows as code rather than formatted content
• Obsidian does support some inline HTML, but it is inconsistent across themes and export formats

Converting HTML to Markdown before importing gives you notes that look right in Obsidian, render correctly in Reading mode, work with graph view relationships (for links), and export cleanly to PDF.

The use cases: saving web research for your knowledge base, importing documentation into your vault, archiving articles for offline reference, or building a reading list with full content.

How to Get the HTML Source of Any Webpage

To convert a webpage to Markdown, you first need its HTML. A few ways to get it:

Method 1 — View Source
In Chrome, Firefox, or Edge: press Ctrl+U (Windows) or Cmd+Option+U (Mac) to open the full page source. Select all (Ctrl+A), copy.

Method 2 — Inspect Element
Right-click on the main article area of the page → Inspect. In the Elements tab, find the main content element (<article>, <main>, or the primary <div>). Right-click the element → Copy → Copy outerHTML. This gets just the article content, not the full page with nav, headers, and ads.

Method 3 — Reader Mode
In Firefox: press F9 to enter Reader Mode. Then View Source to get a clean HTML version with most page clutter removed. Cleaner input produces cleaner Markdown.

Method 2 (copying just the content element) usually gives the best results because it excludes navigation, footers, sidebars, and cookie banners that would pollute the Markdown output.

Sell Custom Apparel — We Handle Printing & Free Shipping

Convert HTML to Markdown and Import to Obsidian

1. Paste the HTML into the converter input area.
2. Click "Convert to Markdown." The output appears instantly — clean Markdown with proper heading levels, bold, italic, links, and lists preserved.
3. Review the output. Script tags, style blocks, and navigation elements are stripped automatically. Check that the main content converted correctly.
4. Copy the Markdown using the Copy button, or click "Download .md" to save a file directly.
5. Import to Obsidian:
   • If you copied: create a new note in Obsidian and paste
   • If you downloaded the .md file: drag it into your vault folder in Obsidian, or move it there via Finder/File Explorer

The imported note will render with proper heading hierarchy, formatted lists, clickable links, and code blocks — the same structure as the original page.

What Converts Cleanly and What to Watch For

Converts well:

• Article headings (h1-h6 → # through ######)
• Bold and italic text
• Ordered and unordered lists, including nested lists
• Links — text and href preserved
• Images — alt text and src preserved as Markdown image syntax
• Code blocks and inline code
• Blockquotes
• Tables (GitHub Flavored Markdown table syntax)

Things to check after converting:

• Images — the src will be the original URL from the page. Obsidian displays external images by default. If you want the images stored locally in your vault, you need to download them separately and update the paths.
• Complex layouts — sidebar content or multi-column layouts may not convert cleanly. Focus on the main content element when copying HTML.
• Embedded media — video embeds, iframes, and interactive elements do not convert to Markdown equivalents. They are stripped or left as placeholder text.

Obsidian-Specific Markdown Tips After Importing

Once your converted content is in Obsidian, a few things that make it more useful:

• Add frontmatter — Add a YAML frontmatter block at the top with source URL, date captured, and tags: --- source: https://example.com date: 2026-04-11 tags: [research, web] ---
• Wikilink key terms — Replace mentions of concepts you have other notes about with [[double-bracket]] links to connect them in your graph view.
• Check heading levels — If the page had an h1 for the site title and an h2 for the article title, your converted Markdown might start at h2. Promote headings if needed.
• Clean up <br> conversions — HTML line breaks sometimes convert to extra blank lines. A quick scan and clean-up makes the note more readable.

Frequently Asked Questions

Can I import HTML files directly into Obsidian?

Obsidian does not natively render .html files as notes. Convert HTML to Markdown first, then import the .md file into your vault.

How do I convert a full webpage to Obsidian Markdown?

Copy the main content HTML from the page (right-click → Inspect → copy outerHTML of the article element), paste into the HTML to Markdown converter, then copy or download the .md output into your vault.

Will images from the webpage work in Obsidian?

Yes — Obsidian displays images from external URLs by default. If you want local images, download them separately and update the image paths in the note.

Does the converter handle nested lists for Obsidian?

Yes. Nested HTML lists convert to properly indented Markdown lists, which Obsidian renders correctly.