# BashWrite

Single bash script that builds a blog from Markdown files in a directory.


Source: https://findsoftware.frbit.cloud/bashwrite/
Last reviewed: 2026-10-23
Listed since: 2026-10-23

## Record

### Links

- home: https://raycc51.github.io/BashWrite/
- repository: https://github.com/RayCC51/BashWrite
- docs: https://github.com/RayCC51/BashWrite/blob/main/README.md

### Identity

- status: active
- maintainer: RayCC
- maintainerType: individual
- parent: unknown
- firstRelease: 2025
- hqCountry: unknown

### Kind

- category: cms
- hosting: unknown
- language: unknown
- runtime: unknown
- runtimeMin: unknown
- basedOn: unknown

### Content

- contentStore: flat-file
- databases: unknown
- adminUi: unknown
- headlessApi: unknown
- templating: unknown
- i18n: unknown

### Rendering and deploy

- runsAs: unknown
- renderingModes: unknown
- installMethod: download script

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 1
- latestReleaseDate: 2025-04-29

### Adoption

- githubStargazers: 6
- packagistDownloads: unknown
- npmWeeklyDownloads: unknown
- contributors: 1
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: unknown
- dependentPackages: unknown

### Sources

- urls: https://github.com/RayCC51/BashWrite/blob/main/README.md (read 2026-10-23)
- urls: https://api.github.com/repos/RayCC51/BashWrite (read 2026-10-23)
- urls: https://github.com/RayCC51/BashWrite/blob/main/README.md (read 2026-10-23)
- maintainer: https://github.com/RayCC51/BashWrite/blob/main/LICENSE (read 2026-10-23)
- maintainerType: https://api.github.com/repos/RayCC51/BashWrite (read 2026-10-23)
- category: https://github.com/RayCC51/BashWrite/blob/main/README.md (read 2026-10-23)
- contentStore: https://github.com/RayCC51/BashWrite/blob/main/README.md (read 2026-10-23)
- installMethod: https://github.com/RayCC51/BashWrite/blob/main/README.md (read 2026-10-23)
- license: https://api.github.com/repos/RayCC51/BashWrite (read 2026-10-23)
- licenseModel: https://github.com/RayCC51/BashWrite/blob/main/LICENSE (read 2026-10-23)
- firstRelease: https://api.github.com/repos/RayCC51/BashWrite/releases?per_page=100 (read 2026-10-23)
- currentMajor: https://api.github.com/repos/RayCC51/BashWrite/releases?per_page=100 (read 2026-10-23)
- latestReleaseDate: https://api.github.com/repos/RayCC51/BashWrite/releases?per_page=100 (read 2026-10-23)
- githubStargazers: https://api.github.com/repos/RayCC51/BashWrite (read 2026-10-23)
- contributors: https://api.github.com/repos/RayCC51/BashWrite/contributors (read 2026-10-23)

## Notes

BashWrite is a single bash script that builds a blog from Markdown files. Posts are written in a `write` folder with frontmatter for the title, description, date, tags, draft status and pinning. Running `./bw.sh b` generates the blog's HTML pages, tag pages, an RSS feed and a sitemap.

The script is installed by downloading `bw.sh` from the release page and editing the settings at its top, such as the blog name, author, base URL and theme color. The [demo blog](https://raycc51.github.io/BashWrite/) is built with the same script.

## Worth knowing

The README lists "Hard to customize" as a limit and says the Markdown converter is not perfect. Its bug list is on the demo blog. The README also describes publishing the generated files to GitHub Pages from a gh-pages branch.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0