{"id":26093166,"url":"https://github.com/eval-agency/markdownmastercms","last_synced_at":"2026-05-06T00:02:33.029Z","repository":{"id":278896254,"uuid":"937045572","full_name":"eVAL-Agency/MarkdownMasterCMS","owner":"eVAL-Agency","description":"Flat-file CMS for static sites that renders markdown client-side for performance and SEO support with server-rendered content","archived":false,"fork":false,"pushed_at":"2026-04-27T09:24:19.000Z","size":22433,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-04-27T11:18:02.396Z","etag":null,"topics":["cms","javascript","markdown","php","static-site","static-site-generator"],"latest_commit_sha":null,"homepage":"https://markdownmaster.com","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eVAL-Agency.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-22T07:43:15.000Z","updated_at":"2026-04-27T09:24:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"ebc39702-c822-4683-999f-8cd09f95c4d4","html_url":"https://github.com/eVAL-Agency/MarkdownMasterCMS","commit_stats":null,"previous_names":["eval-agency/markdownmastercms"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/eVAL-Agency/MarkdownMasterCMS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eVAL-Agency%2FMarkdownMasterCMS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eVAL-Agency%2FMarkdownMasterCMS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eVAL-Agency%2FMarkdownMasterCMS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eVAL-Agency%2FMarkdownMasterCMS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eVAL-Agency","download_url":"https://codeload.github.com/eVAL-Agency/MarkdownMasterCMS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eVAL-Agency%2FMarkdownMasterCMS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32672682,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-05T11:29:49.557Z","status":"ssl_error","status_checked_at":"2026-05-05T11:29:48.587Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cms","javascript","markdown","php","static-site","static-site-generator"],"created_at":"2025-03-09T11:55:45.036Z","updated_at":"2026-05-06T00:02:33.022Z","avatar_url":"https://github.com/eVAL-Agency.png","language":"PHP","funding_links":["https://ko-fi.com/Q5Q013RM9Q"],"categories":[],"sub_categories":[],"readme":"# MarkdownMaster CMS\n\n\nMarkdownMaster CMS is a flat-file framework designed to render HTML content from \nsimple markdown files and HTML templates capable of running entirely client-side,\n(though for best results, should be paired with the server-side component).\n\nThe idea of this is similar to [Jekyll](https://github.com/jekyll/jekyll),\nbut has the benefit of not requiring any pre-compiling for files to be served.\nAll content processing is handled within the browser.\n\nAs a complement system to the client-side engine, a PHP-based server-side component\nfacilitates support for search crawlers to ensure SEO, bots, form submissions, and\nRSS feeds by rendering the Markdown files into HTML on the server.\nThis server-generated content will not exactly match the client-side rendering\nas there are some features lacking, but is sufficient for basic content.\n\nBecause there is no database, registry, or administration of pages, \ndeploying new pages is as simple as just uploading Markdown files to your server.\nThis can be done via automated sync applications such as NextCloud or just uploading\nvia SFTP or your web hosting interface.  **No building or scripts needed for deployment!**\n\nThe client-side javascript rendering in this project was originally based from\n[Chris Diana's CMS.js](https://github.com/chrisdiana/cms.js).\n\n\n![MarkdownMaster CMS Screenshot](img/markdownmaster-cms-basic-blog-theme.webp)\n\n-----\n\n[![Version](https://img.shields.io/github/package-json/v/eVAL-Agency/MarkdownMasterCMS.svg)](https://github.com/eVAL-Agency/MarkdownMasterCMS/releases)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/eVAL-Agency/MarkdownMasterCMS/test.yml?branch=main)](https://github.com/eVAL-Agency/MarkdownMasterCMS/actions)\n[![License](https://img.shields.io/github/license/eVAL-Agency/MarkdownMasterCMS.svg)](https://github.com/eVAL-Agency/MarkdownMasterCMS/blob/main/LICENSE.md)\n\n\nFirst-party professional support for this code, along with server hosting and technology consultation \nis available from [Ohio-local eVAL Agency](https://eval.agency).\n\nAside from business support, you can also help support this project by donating to me directly.\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/Q5Q013RM9Q)\n\n## Features\n\n* Low dependencies (just PHP 8.2+ and a web server)\n* Abstract content types\n* Custom templates\n* Search, filtering, tagging and sorting\n* Apache, Nginx, Mail-in-a-box, and Nextcloud support\n* Small footprint\n* [Remarkable](https://github.com/jonschlinkert/remarkable) Markdown parser embedded (modified)\n* Crawler and SEO support for most content\n* Automatic sitemap.xml generation\n* Theme support\n* RSS 2.0 feed support\n\n\n## Demo\n\nCheck out a [live working site](https://markdownmaster.com?mtm_campaign=github)!\n\n\n## Quick Start\n\n1. Setup/obtain your web environment with at least PHP 8.2 or greater.\n   * [Apache specific install guide](docs/INSTALL.apache.md)\n   * [Mail-in-a-Box specific install guide](docs/INSTALL.mailinabox.md)\n2. Download the **full** \n   [latest release](https://github.com/eVAL-Agency/MarkdownMasterCMS/releases/latest)\n   which includes themes and example content.\n   (Alternatively the **app** package just contains the app, backend, and plugins.)\n3. Upload and extract the tarball to your web root.\n4. Copy / rename `config.example.php` to `config.php` and configure to your liking.\n   * Notably `host` and `theme` are important.\n5. Copy / rename `.htaccess.example` to `.htaccess` and configure if necessary.\n   * Default setup for top-level directory, require SSL, and no `www.` prefix.\n6. Edit theme markup in themes/(themename)/index.html, CSS, and markdown content.\n\n\n## Themes\n\nMarkdownMaster CMS ships with a few themes to get you started, and creating new ones\nis straight forward as you can choose whatever HTML/CSS framework you prefer.\n\n### Basic Blog Theme\n\n![Basic Blog Theme](img/markdownmaster-cms-blog.webp)\n\n### Basic Business Theme\n\n![Basic Business Theme](img/markdownmaster-cms-business.webp)\n\n### Basic Wiki Theme\n\n![Basic Wiki Theme](img/markdownmaster-cms-wiki.webp)\n\n\n## Documentation\n\nDocumentation is available on the \n[official MarkdownMaster CMS website](https://markdownmaster.com/docs.html?mtm_campaign=github),\ncompiled from [docs/](docs/) and other various sources within this project.\n\n[Javascript API documentation](https://markdownmaster.com/jsdocs/latest/) is also available\nfor interfacing with low-level functions within this framework.\n\n\n## How it works\n\nMarkdownMaster CMS pulls the listing of files from either the server's\nautomatic directory index or from the server-side helper application (for faster \nloading and better bot/crawler support). \nThis provides meta information of all pages in the application.\n\nWhen browsing to a file, the source markdown is downloaded from the server\nand rendered into HTML with Remarkable, (by default; this can be swapped out if \nnecessary).\n\nFor bots and crawlers, the server-side component is capable of generating HTML\nfrom the same markdown files.  Not all features are supported in this rendering,\nbut is sufficient for SEO and indexing purposes.\n\n\n## Thanks!\n\n* [Chris Diana](https://github.com/chrisdiana) maintainer of original version of CMS.js\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feval-agency%2Fmarkdownmastercms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feval-agency%2Fmarkdownmastercms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feval-agency%2Fmarkdownmastercms/lists"}