URL to Markdown for Hugo — Web Content to Static Site
Hugo is one Markdown file per page, plus front matter. Migrating web content into a Hugo site usually means manually rewriting articles — slow, error-prone, and full of formatting drift. Convert URLs to Markdown with auto-generated front matter and the migration becomes a directory drop.
The Hugo migration workflow
Standard pattern: list the URLs you want to migrate (export from a sitemap, RSS feed, or hand-curated list). For one-off migrations, paste each URL into mdisbetter.com/convert/url-to-markdown and download the .md file. For batch migrations, roll your own with Trafilatura (best-in-class OSS extractor) plus a small front-matter wrapper — populate title from <title> or og:title, date from article:published_time, description from the meta description, tags from any tag-like classes the source exposes.
Drop each .md file into content/posts/ (or your section of choice) and Hugo's build command does the rest. The front matter feeds Hugo's page variables; the body renders through your theme.
Front matter template
Common YAML for migrated content: title, date, draft: false, description, tags, categories, source_url (custom field for attribution). Customise per the front matter your theme expects.
Frequently asked questions
How do I get Hugo-compatible front matter on converted pages?
MDisBetter's web tool emits the body as plain Markdown — add the YAML front matter as a post-processing step. For batch migrations, a 10-line Python wrapper using Trafilatura's metadata extraction (which gives you title, date, description, tags) generates a Hugo-compatible front matter block per page. Add Hugo-specific fields (draft, categories, theme-required keys) in the same wrapper.
Can I migrate an entire blog from a URL list?
Yes — export your source URLs (sitemap, RSS, hand-curated CSV), run each through Trafilatura (or a similar OSS extractor) in a Python loop, write each output to content/posts/<slug>.md, run hugo build. A 30-line script ties it together; we've seen 500-post migrations complete in under an hour of script time. MDisBetter's web tool covers the per-URL ad-hoc case but doesn't expose a programmatic API for scripted batches.
How do I handle images during URL-to-Hugo migration?
Two patterns. (1) Leave images as remote URLs — fastest, but breaks if the source site dies. (2) Download each referenced image to static/images/migrated/ and rewrite the Markdown image paths to local references. Pattern (2) is recommended for any production migration.
What about page bundles vs single Markdown files?
For pages with associated assets (images, downloadable files), use Hugo page bundles: create content/posts/article-name/index.md and place assets alongside. The conversion gives you the index.md; the asset handling is a post-processing step.
Can I keep the original URLs as redirects?
Add aliases: to the front matter (Hugo generates redirects from each alias to the new URL): aliases: ["/old-blog-path/article-slug/"]. Useful when migrating from one CMS to Hugo and you want to preserve inbound links from the wider web.
Your AI doesn't read PDFs directly. It first has to extract the text, decode the layout, ignore the metadata — before it can even start answering. A Markdown file removes all of those steps. Your AI reads it instantly. So you get faster responses, more accurate results, and zero information lost along the way.
Size-wise, it's 100 to 500 times lighter for the same content. A 15 MB PDF becomes a 30 KB .md file. So your AI knowledge base can hold hundreds of documents instead of a handful.
MDisBetter brings 19 free tools together for that — documents, videos, audio, web pages and prompts.
How does it work?
Drop a PDF, a video, an audio file or a URL. MDisBetter extracts the content and gives you a clean Markdown file. So you can send it to your AI, add it to your project files, or store it in your knowledge base — without losing anything.
Frequently Asked Questions
How do I convert a PDF to Markdown for free?
Upload your PDF to MDisBetter, click Convert, and get structured Markdown in seconds. No signup, no installation — it works directly in your browser. The free plan includes 50 credits per month.
Why is Markdown better than PDF for AI?
Markdown reduces token usage by up to 95% compared to PDF. AI models like ChatGPT and Claude process Markdown far more efficiently because it contains only content structure — no fonts, no layout data, no binary overhead.
What file types can MDisBetter convert?
MDisBetter converts PDF, Word (.docx), plain text, YouTube videos (transcript), audio files (MP3, WAV, M4A, OGG, FLAC, WEBM), and any web page URL to clean Markdown.
Is MDisBetter free?
Yes, free to start. The free plan includes 50 credits per month. All processing happens securely — your files are never stored.
Can I extract a YouTube transcript as Markdown?
Yes. Paste the YouTube video URL, click Convert, and get the full transcript structured as Markdown with headings and timestamps. Perfect for feeding video content to AI tools.
PDF → Markdown
Faithful and structured conversion of your documents
Text to MD, EPUB to MD, MD to PDF, MD Cleaner, Merger, Chunker, Token Counter, Context Builder
Free
—
Word to MD
0.5 credit
per page
Excel to MD
0.5 credit
per conversion
Single URL Scrape
0.5 credit
per call
Site Crawl
1 credit
per page
Translate
1 credit
per 10 000 chars (min 1, free re-translation on cache hit)
Prompt Optimizer
1 credit
per call
System Prompt Generator
1 credit
per call
Audio to MD
2 credits
per minute
Video to MD
2 credits
per minute
YouTube to MD
2 credits
per minute
Image OCR
4 credits
per image (0 on cache hit)
PDF to MD
4 credits
per page
PPTX to MD
4 credits
per slide
Questions
Yes! You get 50 credits every month to use any tool. Basic tools like MD Cleaner or Token Counter cost just 0.5 credit per use. When you run out, credits reset the next month or you can upgrade for more.
Wait for your monthly reset or upgrade to a higher plan. Credits renew on your billing date each month.
Yes, cancel anytime with one click. No questions asked. You keep access until the end of your billing period.
Pro gives you 30,000 credits for $29 — that's 30x more credits than Starter for just 3x the price. Every credit costs less, so you get far more value per dollar.