# Turn a Folder of Markdown into a Website with seemore > Source: > Published: 2026-10-28 05:29:48+00:00 You can turn a folder of Markdown into a website in two ways: with the desktop app or with one command. Both ways use [seemore](https://github.com/arifszn/seemore), an open-source project that I built. It uses the MIT license. Markdown is plain text with simple marks for headings and lists. AI tools write it fast: specs, notes, guides, READMEs and whole folders. A person cannot read that much raw text at that speed. seemore shows the folder as a site with navigation and search instead. You need no config file and no code. seemore does not move your files. If you stop using it, your files stay where they are. The desktop app opens a folder or a `.md` file as a site in its own window. It runs on macOS, Windows and Linux. To open one file, double-click a `.md` file or choose **File > Open File**. The app also has an integrated terminal. A terminal is a text window where you type commands. It opens in the site's folder. The command line needs Node.js 20 or newer. ``` cd my-docs npx seemore ``` `http://localhost:4040` in your browser. The word localhost means your own computer. The site is the same either way. A skill is a set of instructions that an AI coding agent loads. With the seemore skill, you describe what you want and the agent runs the commands. In Claude Code, install the skill as a plugin. ``` /plugin marketplace add arifszn/seemore-skill /plugin install seemore ``` `seemore` in the answer. Then ask in plain words: ``` Turn this folder of notes into a docs site I can read in my browser ``` You can also call the skill by name with `/seemore`. In Claude Code, the full name is `/seemore:seemore`. The skill works in any agent that supports the `SKILL.md` format. The install guide lists Claude Code, OpenCode, Codex, Antigravity, Gemini CLI, Cursor, Windsurf, Kimi and others. For an agent other than Claude Code, you can paste this line into the agent: ``` Fetch and follow the install instructions from https://raw.githubusercontent.com/arifszn/seemore-skill/refs/heads/main/INSTALL.md ``` `meta.json` file first, then an `order` field in the frontmatter, then the title. Frontmatter is the block of settings at the top of a page.`[[wikilinks]]`, Mermaid and D2 diagrams, click-to-zoom images and embedded PDFs. **Save** writes the change to the file on disk. Inline editing works only in a local preview. It does not work on a published site. seemore writes to your files only when you save an inline edit or run `build` or `export`. The preview is live. Add, rename, retitle or delete a file, and the site updates at once, with navigation and search. You see pages appear while the agent writes them. Two options keep it next to your work. Run an AI agent, git or a script in the app's integrated terminal, and the pages update as the files change. The editor extension shows the site as a panel beside your code. It covers VS Code, Cursor, Antigravity and other VS Code-compatible editors. It needs no extra terminal and no browser tab. The site opens beside the editor, for the folder of that file. The extension bundles everything it needs, so nothing downloads and nothing goes on your PATH. Build the folder into plain web files. In the desktop app, choose **File > Build Site**. In a terminal, run this command. ``` npx seemore build ``` The build writes a `dist/` folder. It holds one `index.html` file per page and a `404.html` file. Upload the folder to Netlify, Surge, Cloudflare Pages, GitHub Pages or any web host. A config file is optional. GitHub Pages serves a project at an address such as `username.github.io/my-repo/`. The part after the host name is a subpath. With the wrong subpath, a page can load with no styling and no working links. Set it once. `seemore.config.ts` next to your content.`base: '/my-repo/'`.` npx seemore build`. You can also pass `--base /my-repo/` to the build. Add `auth: true` to `seemore.config.ts`. Then set the password when you build. ``` SEEMORE_PASSWORD='a-long-passphrase' npx seemore build ``` seemore encrypts the site content, so nobody can read a copy of the build without the password. Use the **Actions** button above a page. It can copy the page as Markdown or export it as one HTML file. In the desktop app, choose **File > Export Page as HTML**. In a terminal, run `npx seemore export docs/spec.md`. It writes `spec.html` next to the Markdown. The HTML file is self-contained and opens offline from a double-click.