PHPackages hjue/justwriting - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Parsing & Serialization](/categories/parsing) 4. / 5. hjue/justwriting ActiveProject[Parsing & Serialization](/categories/parsing) hjue/justwriting ================ Markdown blog system 1.0.0(11y ago)5292778[6 issues](https://github.com/hjue/JustWriting/issues)MITPHPPHP >=5.3.0 Since Jan 20Pushed 10y ago31 watchersCompare [ Source](https://github.com/hjue/JustWriting)[ Packagist](https://packagist.org/packages/hjue/justwriting)[ Docs](https://github.com/hjue/JustWriting)[ RSS](/packages/hjue-justwriting/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (3)Used By (0)Security (1) JustWriting =========== [](#justwriting) [![Build Status](https://camo.githubusercontent.com/4d78d0731d177209fe0a461a02a93c1f6091f4a95d87c15e297bfab43e17a657/68747470733a2f2f6170692e7472617669732d63692e6f72672f686a75652f4a75737457726974696e672e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/hjue/JustWriting)[![Latest Stable Version](https://camo.githubusercontent.com/416d9984207fa788a463de094ee372511683a73190ece301d41ac9ba8acc18e7/68747470733a2f2f706f7365722e707567782e6f72672f686a75652f6a75737477726974696e672f762f737461626c652e737667)](https://packagist.org/packages/hjue/justwriting) [![Total Downloads](https://camo.githubusercontent.com/239bcb9aeaf301d65ebd8962aaa5885c9651e9747fd5dcc774c28638f640ed4f/68747470733a2f2f706f7365722e707567782e6f72672f686a75652f6a75737477726974696e672f646f776e6c6f6164732e737667)](https://packagist.org/packages/hjue/justwriting) [![Latest Unstable Version](https://camo.githubusercontent.com/dcdfe5736059d99f1238b91cef60f7110bb0029e45568e8674e3e58c7a9ff8c5/68747470733a2f2f706f7365722e707567782e6f72672f686a75652f6a75737477726974696e672f762f756e737461626c652e737667)](https://packagist.org/packages/hjue/justwriting) [![License](https://camo.githubusercontent.com/26653c3da5f5498467a90e87fb69dc024632c6a82a5b56142384b230315c9f20/68747470733a2f2f706f7365722e707567782e6f72672f686a75652f6a75737477726974696e672f6c6963656e73652e737667)](https://packagist.org/packages/hjue/justwriting) ### Introduction [](#introduction) [**Justwriting**](https://github.com/hjue/JustWriting) is a simple blog platform. You just need the text written in Markdown, upload the .md file to website, and it will show .md files as posts on your website. It can synchronize files to the server by Dropbox, so you don't have to care about losing your files when the server breaks, as all files can be stored on your local devices. If you share the folder in Dropbox with others, all members can add or edit posts. Of course, if you have problems to install Dropbox on servers, it also can upload files by FTP, SVN or git, or any other methods you can upload files with. [Oneline Demo on SAE](http://justwriting.sinaapp.com/) [Oneline Demo on OpenShift](http://php-justwriting.rhcloud.com/) If you have any questions, feel free to [ask me](https://github.com/hjue/JustWriting/issues/new). [中文版使用说明移步这里](https://github.com/hjue/JustWriting/blob/master/README.zh.md) [![](https://raw.githubusercontent.com/hjue/JustWriting/develop/docs/page.png)](https://raw.githubusercontent.com/hjue/JustWriting/develop/docs/page.png) [![](https://raw.githubusercontent.com/hjue/JustWriting/develop/docs/preview_deepure.png)](https://raw.githubusercontent.com/hjue/JustWriting/develop/docs/preview_deepure.png) ### Requirements [](#requirements) - PHP 5.3.6+ ### Features [](#features) - Simple blog platform - No need for an onlinetoc editor, just write your post offline on any device - No need for a database - Write with Markdown - Supports code highlighting - Supports Latex math equations - Supports Toc - Multiple themes - Supports updates via Dropbox - Supports post via API - Supports Jekyll post file ### Installation [](#installation) 1. Set blog settings in 'settings.php' 2. Upload code to php space 3. Upload your Markdown files to the 'posts' folder 4. Open website, that's it. ### Deploy With Docker [](#deploy--with-docker) ``` docker pull hjue/justwriting ``` [JustWriting Docker Repo ](https://github.com/hjue/dockerfiles/tree/master/justwriting) #### Web Server Configuration [](#web-server-configuration) - [Apache Setting](https://gist.github.com/hjue/4da6b1e897de31d135f7) - [Nginx Setting](https://gist.github.com/hjue/647dc694dc3b67994202) ### Themes for JustWriting [](#themes-for-justwriting) - [rock](https://github.com/hjue/JustWriting/tree/master/templates/rock) - [deepure](https://github.com/hjue/JustWriting/tree/master/templates/deepure) - [simpleBlue](https://github.com/ncosnard/jw-theme-simpleBlue) - [bmore](https://github.com/JellyBool/JustWriting-themes/tree/master/bmore) - [Jelly](https://github.com/JellyBool/JustWriting-themes/tree/master/Jelly) ### Write Articles [](#write-articles) #### Head information [](#head-information) Put the head information at the beginning of the .md file. ``` Date: 2014-12-31 Title: Post tilte Intro: Post abstract Tags: justwriting blog Toc:yes Status: public Position: 1 Contents ``` The `status` can also be defined as `draft`, then this file will not appear on the website. The `Toc` can control show the table of contents or not,accept yes or no. It also supports Jekyll head information. ### Add Posts [](#add-posts) As **Justwriting** will convert any .md file in the posts folder to post, so you just need upload `.md` file to the servers through any ways. Here list some methods: #### 1. Sync with Dropbox client Automatically [](#1-sync-with-dropbox-client-automatically) If running **Justwriting** on VPS, suggest to update post through Dropbox. [Installation Process](https://github.com/hjue/JustWriting/wiki/%E4%BD%BF%E7%94%A8Dropbox%E5%92%8CJustwriting%E6%90%AD%E5%BB%BA%E4%B8%AA%E4%BA%BA%E5%8D%9A%E5%AE%A2)。 #### 2. Sync with Dropbox webhook URL [](#2-sync-with-dropbox-webhook-url) For virtual host user, it may not able to install Dropbox client, **JustWritting** provide a function to manually pull files from Dropbox. 1. [ Create App ](https://www.dropbox.com/developers/apps) - Generate access token - Add Webhook URI `http:///sync/dropbox/download` [![Dropbox Create App](docs/images/dropbox-create-app.png)](docs/images/dropbox-create-app.png) 2. Configure params in settings.php: ``` $blog_config['dropbox']['key'], $blog_config['dropbox']['secret'], $blog_config['dropbox']['access_token'] ``` > [http://your\_justwriting\_site/sync/dropbox/download ](http://your_justwriting_site/sync/dropbox/download) is the URL for syncing posts #### 3. Through API [](#3-through-api) Justwriting supports post through API. If use the API, it need true on the option in settings.php, and set the API Key in it. Click here to check the [API documents](https://github.com/hjue/JustWriting/wiki/API) ### Who uses JustWriting? [](#who-uses-justwriting) - [hjue](http://www.hjue.me) - [JellyBool](http://www.jellybool.com/) - [Colin](http://doc.mekesim.com/) - [周渊](http://blog.zhouyuan11.cn/) - [花开堪折枝](http://yaming.coding.io/) - [Jings](http://nsaos.com/) - [Tictech](http://tictech.info/) - [海棠红叶](http://www.htredleaf.com/) - [Unee Wang](http://unee.wang/) - [fuis](http://www.fuisblog.com/) - [CatCoder](http://www.catcoder.com) - [吴银春的博客](http://blog.wuyinchun.cn/) If you are using Justwriting, and would like to be listed here, [tell me](https://github.com/hjue/JustWriting/issues/new). ### Contributors [](#contributors) - [xieyu33333](https://github.com/xieyu33333) - [mekesim](https://github.com/mekesim) License ------- [](#license) Please see the file called LICENSE. ### Health Score 35 — LowBetter than 79% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity30 Limited adoption so far Community24 Small or concentrated contributor base Maturity59 Maturing project, gaining track record Bus Factor1 Top contributor holds 95% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 4133d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/c677364de8b10809e4964c675982973e0630aa04d44a382a400e54a3b44ea237?d=identicon)[hjue](/maintainers/hjue) --- Top Contributors [![hjue](https://avatars.githubusercontent.com/u/1135045?v=4)](https://github.com/hjue "hjue (209 commits)")[![xieyu33333](https://avatars.githubusercontent.com/u/2143576?v=4)](https://github.com/xieyu33333 "xieyu33333 (5 commits)")[![jomo](https://avatars.githubusercontent.com/u/3585743?v=4)](https://github.com/jomo "jomo (4 commits)")[![PaulosV](https://avatars.githubusercontent.com/u/4086023?v=4)](https://github.com/PaulosV "PaulosV (1 commits)")[![yangjianlin-c](https://avatars.githubusercontent.com/u/4256458?v=4)](https://github.com/yangjianlin-c "yangjianlin-c (1 commits)") --- Tags markdownblog ### Embed Badge ![Health badge](/badges/hjue-justwriting/health.svg) ``` [![Health](https://phpackages.com/badges/hjue-justwriting/health.svg)](https://phpackages.com/packages/hjue-justwriting) ``` ### Alternatives [erusev/parsedown Parser for Markdown. 15.0k151.8M732](/packages/erusev-parsedown)[league/commonmark Highly-extensible PHP Markdown parser which fully supports the CommonMark spec and GitHub-Flavored Markdown (GFM) 2.9k404.0M702](/packages/league-commonmark)[michelf/php-markdown PHP Markdown 3.5k52.4M345](/packages/michelf-php-markdown)[league/html-to-markdown An HTML-to-markdown conversion helper for PHP 1.9k28.6M199](/packages/league-html-to-markdown)[cebe/markdown A super fast, highly extensible markdown parser for PHP 1.0k32.5M136](/packages/cebe-markdown) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)