2018-06-22 21:07:30 +02:00
|
|
|
CodiMD
|
2015-05-04 15:53:29 +08:00
|
|
|
===
|
|
|
|
|
2018-06-22 21:07:30 +02:00
|
|
|
[![#CodiMD on matrix.org][matrix.org-image]][matrix.org-url]
|
2017-02-15 18:14:58 +08:00
|
|
|
[![build status][travis-image]][travis-url]
|
2017-10-08 19:15:29 +08:00
|
|
|
[![version][github-version-badge]][github-release-page]
|
2018-04-11 09:38:45 +02:00
|
|
|
[![POEditor][poeditor-image]][poeditor-url]
|
2015-08-15 04:15:42 +00:00
|
|
|
|
2019-04-03 23:09:36 +02:00
|
|
|
CodiMD lets you create real-time collaborative markdown notes. You can test-drive
|
|
|
|
it by visiting our [CodiMD demo server][codimd-demo].
|
2019-03-31 20:10:32 +02:00
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
It is inspired by Hackpad, Etherpad and similar collaborative editors. This
|
|
|
|
project originated with the team at [HackMD](https://hackmd.io) and now forked
|
|
|
|
into its own organisation. [A longer writeup can be read in the history doc](docs/history.md).
|
2015-05-04 15:53:29 +08:00
|
|
|
|
2019-04-03 23:09:36 +02:00
|
|
|
[][codimd-demo-features]
|
2015-05-15 12:58:13 +08:00
|
|
|
|
2017-10-13 15:59:57 +08:00
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
## Community and Contributions
|
2017-10-13 15:59:57 +08:00
|
|
|
|
2019-04-03 23:09:36 +02:00
|
|
|
We welcome contributions! There's a lot to do: If you would like to report bugs,
|
|
|
|
the [issue tracker][github-issue-tracker] is the right place. If you can help
|
|
|
|
translating, find us on [POEditor][poeditor-url]. To get started developing,
|
2019-03-31 16:02:05 +02:00
|
|
|
take a look at the [docs/dev](docs/dev) directory. In any case: come talk to us,
|
|
|
|
we'll be delighted to help you with the first steps.
|
2016-06-02 00:13:01 +08:00
|
|
|
|
2019-04-03 23:09:36 +02:00
|
|
|
To stay up to date with our work or get support it's recommended to join our
|
|
|
|
[Matrix channel][matrix.org-url], stop by our [community forums][codimd-community]
|
|
|
|
or subscribe to the [release feed][github-release-feed]. We also engage in
|
|
|
|
regular [community calls][codimd-community-calls] which you are very welcome to join.
|
2018-04-05 01:21:20 +02:00
|
|
|
|
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
## Installation / Upgrading
|
2016-10-04 16:41:26 +08:00
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
You can run CodiMD in a number of ways, and we created setup instructions for
|
|
|
|
all of these:
|
2017-10-08 19:37:20 +08:00
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
* [Docker](docs/setup/docker.md)
|
|
|
|
* [Kubernetes](docs/setup/kubernetes.md)
|
|
|
|
* [Cloudron](docs/setup/cloudron.md)
|
|
|
|
* [Heroku](docs/setup/heroku.md)
|
|
|
|
* [manual setup](docs/setup/manual-setup.md)
|
2017-10-08 19:37:20 +08:00
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
If you do not wish to run your own setup, you can find a commercial offering at
|
|
|
|
https://hackmd.io. This is not the same codebase as this one, but it is a very
|
|
|
|
similar project.
|
2015-07-02 00:10:20 +08:00
|
|
|
|
2016-10-04 16:41:26 +08:00
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
## Configuration
|
2016-10-04 16:41:26 +08:00
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
Theres two main ways to configure your CodiMD instance:
|
|
|
|
[Config file](docs/configuration-config-file.md) or
|
|
|
|
[environment variables](docs/configuration-env-vars.md). You can choose what
|
|
|
|
works best for you.
|
2015-05-15 12:58:13 +08:00
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
CodiMD can integrate with
|
2016-10-04 16:41:26 +08:00
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
* facebook, twitter, github, gitlab, mattermost, dropbox, google, ldap, saml and [oauth2](docs/guides/auth/oauth.md) **for login**
|
|
|
|
* imgur, s3, minio, azure **for image/attachment storage** (files can also be local!)
|
|
|
|
* dropbox **for export and import**
|
2018-06-24 13:22:51 +02:00
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
More info about that can be found in the configuration docs above.
|
2016-04-20 18:03:55 +08:00
|
|
|
|
2016-10-04 16:41:26 +08:00
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
## Browser support
|
2016-03-15 11:30:43 +08:00
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
To use CodiMD, your browser should match or exceed these versions:
|
2015-05-08 11:52:30 +08:00
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
-  Chrome >= 47, Chrome for Android >= 47
|
|
|
|
-  Safari >= 9, iOS Safari >= 8.4
|
|
|
|
-  Firefox >= 44
|
|
|
|
-  IE >= 9, Edge >= 12
|
|
|
|
-  Opera >= 34, Opera Mini not supported
|
|
|
|
- Android Browser >= 4.4
|
2017-10-08 19:37:20 +08:00
|
|
|
|
|
|
|
|
2019-04-03 23:09:36 +02:00
|
|
|
## Related Tools
|
|
|
|
|
|
|
|
Our community has created related tools, we'd like to highlight [codimd-cli](https://github.com/codimd/cli)
|
|
|
|
which lets you use CodiMD from the comfort of your command line.
|
|
|
|
|
|
|
|
|
2017-10-08 19:37:20 +08:00
|
|
|
# License
|
|
|
|
|
2019-03-31 16:02:05 +02:00
|
|
|
Licensed under AGPLv3. For our list of contributors, see [AUTHORS](AUTHORS).
|
2017-03-14 23:30:35 +08:00
|
|
|
|
2018-06-22 21:07:30 +02:00
|
|
|
[matrix.org-image]: https://img.shields.io/badge/Matrix.org-%23CodiMD@matrix.org-green.svg
|
|
|
|
[matrix.org-url]: https://riot.im/app/#/room/#codimd:matrix.org
|
2019-03-28 22:36:26 +01:00
|
|
|
[travis-image]: https://travis-ci.org/codimd/server.svg?branch=master
|
|
|
|
[travis-url]: https://travis-ci.org/codimd/server
|
|
|
|
[github-version-badge]: https://img.shields.io/github/release/codimd/server.svg
|
2019-03-27 19:31:20 +01:00
|
|
|
[github-release-page]: https://github.com/codimd/server/releases
|
|
|
|
[github-release-feed]: https://github.com/codimd/server/releases.atom
|
2019-03-31 16:02:05 +02:00
|
|
|
[github-issue-tracker]: https://github.com/codimd/server/issues/
|
2018-04-16 21:08:24 +02:00
|
|
|
[poeditor-image]: https://img.shields.io/badge/POEditor-translate-blue.svg
|
2018-04-11 09:38:45 +02:00
|
|
|
[poeditor-url]: https://poeditor.com/join/project/1OpGjF2Jir
|
2019-04-03 23:09:36 +02:00
|
|
|
[codimd-demo]: https://demo.codimd.org
|
|
|
|
[codimd-demo-features]: https://demo.codimd.org/features
|
|
|
|
[codimd-community]: https://community.codimd.org
|
2019-04-03 23:56:19 +02:00
|
|
|
[codimd-community-calls]: https://community.codimd.org/t/codimd-community-call/19/2
|