gitwtfhub

wtf is obsidipedia?

ivanturko/obsidipedia — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · vibe coderComplexity · 2/5Setup · moderate

TL;DR

A Python script that converts a Wikipedia article into a clean Markdown note for Obsidian, with images downloaded and embedded automatically.

Mindmap

mindmap
  root((Obsidipedia))
    What it does
      Fetches Wikipedia HTML
      Cleans up clutter
      Converts to Markdown
    Image handling
      Downloads all images
      Includes math formulas
      Obsidian embed format
    Requirements
      Python 3.12 plus uv
      pandoc installed separately
    Customization
      Edit AUTHOR variable
      Edit USER_AGENT variable
    Audience
      Obsidian users
      Note takers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Turn a Wikipedia article into a clean, readable Obsidian note with one command.

REASON 2

Automatically download and embed every image from a Wikipedia article, including math formula images.

REASON 3

Save research notes from Wikipedia directly into an Obsidian vault's inbox folder.

REASON 4

Personalize the note's author and frontmatter by editing two variables in the script.

What's in the stack?

Pythonuvpandoc

How it stacks up

ivanturko/obsidipedia0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity2/54/54/5
Audiencevibe coderdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Python 3.12+, the uv tool, and pandoc installed separately through your system's package manager.

Wtf does this do

Obsidipedia is a small script that takes the title of a Wikipedia article and turns it into a clean, ready to use note for Obsidian, a popular note taking app. Wikipedia pages look fine in a browser, but the underlying HTML is full of clutter such as edit links, footnote markers, large info boxes, hidden tracking elements, and math formulas that are actually tiny images rather than text. The script works through a clear sequence of steps. It fetches the same rendered HTML your browser would show for the article, strips out the clutter mentioned above, then runs the cleaned up HTML through a tool called pandoc to convert it into Markdown while keeping tables, lists, and code blocks intact. It downloads every image referenced in the article, including the small SVG images Wikipedia uses for math formulas, and rewrites each image link into Obsidian's own embed format so the pictures show up correctly once the note is opened. Finally it saves everything as a new Markdown file with a timestamp and some frontmatter metadata at the top, ready to drop into your notes folder. The author is upfront that not every Wikipedia page converts perfectly, especially pages with unusual tables or tables nested inside other tables, and that some manual cleanup may occasionally be needed afterward. Math heavy articles can also take longer to process since each formula requires its own separate image download, sometimes 30 or more for a single page. To use it, you need Python 3.12 or newer along with a tool called uv, which automatically installs the script's other dependencies for you, plus pandoc installed separately through your system's package manager. You run the script from your vault's root folder, giving it an article title and optional settings like output folder or language. There is no separate settings file. To personalize the note template or the identification string sent to Wikipedia, you edit two variables directly near the top of the script file.

Yoink these prompts

Prompt 1
Explain what happens step by step when this script converts a Wikipedia article into a Markdown note.
Prompt 2
Help me install pandoc and uv so I can run this script on my system.
Prompt 3
Walk me through changing the AUTHOR and USER_AGENT variables in obsidipedia.py.
Prompt 4
Show me the command to convert the Wikipedia article on Kelly criterion into my Obsidian inbox folder.

Frequently asked questions

wtf is obsidipedia?

A Python script that converts a Wikipedia article into a clean Markdown note for Obsidian, with images downloaded and embedded automatically.

What language is obsidipedia written in?

Mainly Python. The stack also includes Python, uv, pandoc.

How hard is obsidipedia to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is obsidipedia for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.