https://github.com/chatenhancer/lepapier
lepapier.app is the clean markdown editor with no distractions
https://github.com/chatenhancer/lepapier
astro editor markdown offline ssg static static-site static-site-generator
Last synced: 9 days ago
JSON representation
lepapier.app is the clean markdown editor with no distractions
- Host: GitHub
- URL: https://github.com/chatenhancer/lepapier
- Owner: chatenhancer
- License: gpl-3.0
- Created: 2026-06-11T20:23:10.000Z (12 days ago)
- Default Branch: main
- Last Pushed: 2026-06-12T03:49:47.000Z (12 days ago)
- Last Synced: 2026-06-12T04:09:52.922Z (12 days ago)
- Topics: astro, editor, markdown, offline, ssg, static, static-site, static-site-generator
- Language: TypeScript
- Homepage: https://lepapier.app
- Size: 765 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Lepapier.app
Lepapier (from French: le papier, "the paper") is a local-first Markdown writing app for drafting, editing, previewing, and exporting documents from the browser.
It is designed to serve as a quiet writing surface with the least distractions possible, while still handling the practical parts of publishing: frontmatter, images, Markdown previews, drafts, importing and exporting, syncing with local files, and portability.
It builds into a single `index.html` file that can be placed and opened anywhere.
[Website](https://lepapier.app) · [Start writing](https://lepapier.app/editor/) · [Releases](https://github.com/chatenhancer/lepapier/releases)
## What’s it good for?
It was mainly developed to cleanly create, edit, and export Markdown archives for static *Astro* sites and blogs, but it can be used to edit any form of Markdown content.
**Please note that the app is unfinished**. For now it only has the features I need to publish content on blogs like https://chatenhancer.com, which are _Astro_ sites.
Feature set and robustness will improve in the future as I go along.
## Features (unfinished)
- Local-first editing with drafts saved in the browser.
- Multi-document workspace with document selection, bulk download, and bulk delete.
- Open a Markdown file or a folder of Markdown files.
- Open and sync a Markdown file or folder using the File System Access API where supported.
- Import referenced image assets from opened folders.
- Add cover images and document images, then export them with Markdown.
- Download one document as `.md` when no assets are needed, or export documents and assets as a `.zip`.
- Live Markdown preview with editable preview text and image controls.
- Frontmatter fields for title, date, slug, description, tags, and cover image.
- Optional manual Chrome built-in AI metadata refresh buttons for title, description, and tags.
- Smart punctuation and image filename randomization options.
- PWA-ready standalone app built with Vite and vanilla DOM APIs.
## Privacy
- Drafts and settings stay in browser storage.
- Files opened through the File System Access API stay local to your browser session and granted handles.
- Metadata suggestions use Chrome's built-in AI when available. After Chrome installs the model, metadata suggestions run locally.
## Screenshots
## Development
Install dependencies:
```sh
npm install
```
Start the local dev server:
```sh
npm run dev
```
Run TypeScript checks:
```sh
npm run check
```
Run tests:
```sh
npm test
```
Build for production:
```sh
npm run build
```
Preview the production build:
```sh
npm run preview
```
Run the landing/docs site and editor together:
```sh
npm run docs:dev
```
Build the GitHub Pages artifact:
```sh
npm run pages:build
```
## Release
1. Update `version` in `package.json`.
2. Run `npm run verify`.
3. Commit the version bump and create a tag such as `v0.1.2`.
4. Push the commit and tag.
The release workflow validates exact `vX.Y.Z` tags against `package.json`, creates the release zip, attaches it to a GitHub Release, and deploys the tagged app to `https://lepapier.app/editor/`.
## Architecture
- `Vite` serves and bundles the standalone app.
- The editor is a vanilla DOM app with direct access to browser-native APIs: IndexedDB, File System Access, clipboard images, PWA support, and Chrome built-in AI.
- Draft text is saved in `localStorage`; selected image files and editable file/folder handles are saved in IndexedDB.
- Exports are generated client-side as Markdown files or zip archives depending on selected documents and referenced assets.
## License
GPL-3.0-or-later. See [LICENSE](LICENSE).