siyuan/README.md

121 lines
6.7 KiB
Markdown
Raw Normal View History

2020-09-02 13:25:54 +08:00
<p align="center">
<img alt="SiYuan" src="https://b3log.org/images/brand/siyuan-128.png">
<br>
2021-02-18 22:22:33 +08:00
<em>The next generation PKM system, your digital garden</em>
2020-09-02 13:25:54 +08:00
<br><br>
<a title="Releases" target="_blank" href="https://github.com/siyuan-note/siyuan/releases"><img src="https://img.shields.io/github/release/siyuan-note/siyuan.svg?style=flat-square&color=FF9900"></a>
<a title="Downloads" target="_blank" href="https://github.com/siyuan-note/siyuan/releases"><img src="https://img.shields.io/github/downloads/siyuan-note/siyuan/total.svg?style=flat-square&color=blueviolet"></a>
2021-02-18 22:19:09 +08:00
<a title="Docker Pulls" target="_blank" href="https://hub.docker.com/r/b3log/siyuan"><img src="https://img.shields.io/docker/pulls/b3log/siyuan.svg?logo=docker&style=flat-square&color=99CCFF"></a>
2021-02-18 20:33:12 +08:00
<a title="Discord" target="_blank" href="https://discord.gg/bzfCBwMzdP"><img src="https://img.shields.io/discord/808152298789666826?label=discord&logo=discord&style=flat-square&color=orange"></a>
2020-09-02 13:27:06 +08:00
<a title="Hits" target="_blank" href="https://github.com/siyuan-note/siyuan"><img src="https://hits.b3log.org/siyuan-note/siyuan.svg"></a>
2020-09-02 13:25:54 +08:00
</p>
2020-09-10 16:01:59 +08:00
<p align="center">
2021-02-05 10:02:38 +08:00
<a href="https://github.com/siyuan-note/siyuan/blob/master/README_zh_CN.md">中文</a>
2020-09-10 16:01:59 +08:00
</p>
2020-08-30 23:47:52 +08:00
2021-02-05 10:02:38 +08:00
## 💡 Introduction
2020-09-10 16:01:59 +08:00
2021-05-14 22:55:14 +08:00
SiYuan is a local-first personal knowledge management system, support fine-grained block-level reference and Markdown WYSIWYG.
2020-09-10 16:01:59 +08:00
2021-02-06 23:50:34 +08:00
![bg1.png](https://cdn.jsdelivr.net/gh/siyuan-note/siyuan@762fc276da1f713551b61799f04a3661ccd17369/screenshots/bg1.png)
![bg3.png](https://cdn.jsdelivr.net/gh/siyuan-note/siyuan@762fc276da1f713551b61799f04a3661ccd17369/screenshots/bg3.png)
2020-10-06 09:22:23 +08:00
2021-02-05 10:02:38 +08:00
## ✨ Features
* Content block
* Block-level reference and two-way links
* Document relationship diagram, global relationship diagram
2021-05-14 23:02:48 +08:00
* Properties
* SQL query embed
2021-05-14 22:55:14 +08:00
* Protocol `siyuan://`
2021-05-14 23:02:48 +08:00
* Editor
2021-05-14 23:09:25 +08:00
* Block-style
2021-05-14 23:08:34 +08:00
* Markdown WYSIWYG
2021-05-14 23:02:48 +08:00
* List outline
* Block zoom-in
* Block horizontal layout
* Million-word large document editing
* Mathematical formulas, charts, flowcharts, Gantt charts, timing charts, staffs, etc.
2021-05-14 22:55:14 +08:00
* Web clipping
2021-02-05 10:02:38 +08:00
* Hierarchical tag
2021-05-14 22:55:14 +08:00
* Multi-tab, drag and drop to split screen
2021-02-05 10:02:38 +08:00
* Fulltext search
* Themes and icons
* Built-in bright and dark themes
* Built-in two sets of icons, Material and Ant Design
* Support custom themes and icons
* Export
2021-05-14 22:55:14 +08:00
* Standard Markdown with assets
2021-02-05 10:02:38 +08:00
* Content block reference provides anchor text + embedded blockquote option
2021-02-18 22:17:17 +08:00
* Copy to WeChat MP, Zhihu and Yuque
2021-05-14 23:03:21 +08:00
* Incremental data synchronization
2021-05-14 22:55:14 +08:00
* [Online Workspace](https://ld246.com/xanadu/)
* [Online Publishing](https://ld246.com/udanax/)
* Android APP
* Docker deployment
2020-08-30 23:49:14 +08:00
2021-02-05 10:02:38 +08:00
## 🗺️ Roadmap
2020-09-03 11:46:50 +08:00
2021-02-06 09:42:32 +08:00
* [SiYuan development plan and progress](https://github.com/siyuan-note/siyuan/projects)
2021-02-05 10:02:38 +08:00
* [SiYuan Change logs](https://github.com/siyuan-note/siyuan/blob/master/CHANGE_LOGS.md)
2020-09-03 23:13:25 +08:00
2021-02-05 10:02:38 +08:00
## 🛠️ Download Setup
2020-09-10 16:01:59 +08:00
2021-02-15 15:16:42 +08:00
* [B3log](https://b3log.org/siyuan/en/download.html)
2020-09-10 16:01:59 +08:00
* [GitHub](https://github.com/siyuan-note/siyuan/releases)
2020-12-28 09:30:34 +08:00
* [Docker](https://hub.docker.com/r/b3log/siyuan)
2020-09-10 16:01:59 +08:00
2021-03-09 09:38:57 +08:00
To get the latest Insider Preview, please send an email with your GitHub login name to 845765@qq.com, and we will invite you to join the SiYuan Insider Preview team, thanks.
2021-03-08 09:08:32 +08:00
2021-02-05 10:02:38 +08:00
## 📜 Documentation
2020-09-10 16:01:59 +08:00
2021-02-05 10:02:38 +08:00
* [User Guide](https://ld246.com/udanax/1602224134353)
* [SiYuan - A desktop Markdown Block-Reference and Bidirectional-Link note-taking application](https://ld246.com/article/1598872180233)
* [Markdown implements the exploration of block-level reference bidirectional links](https://ld246.com/article/1597226949061)
2020-09-10 16:01:59 +08:00
2021-02-05 10:02:38 +08:00
## 🏘️ Community
2020-09-10 16:01:59 +08:00
2021-02-08 10:49:55 +08:00
* [Discord](https://discord.gg/bzfCBwMzdP)
2020-09-03 23:13:25 +08:00
2021-02-05 10:02:38 +08:00
## 💌 Participate in contribution
2020-12-12 23:48:56 +08:00
2021-02-05 10:02:38 +08:00
At present, some components of SiYuan are open source, and contributions are welcome.
2020-12-12 23:48:56 +08:00
2021-02-05 10:02:38 +08:00
* [User Guide](https://github.com/siyuan-note/user-guide-en_US)
* [Appearance and language](https://github.com/siyuan-note/appearance)
* [Markdown Engine](https://github.com/88250/lute)
2021-05-14 22:55:14 +08:00
* [Chrome web clipping extension](https://github.com/siyuan-note/siyuan-chrome)
2021-01-12 23:08:31 +08:00
2021-02-05 10:02:38 +08:00
## 🙏 Acknowledgement
2021-01-12 23:08:31 +08:00
2021-02-05 10:02:38 +08:00
SiYuan is made possible by the [Vditor](https://github.com/Vanessa219/vditor) and [Lute](https://github.com/88250/lute) open source project and other open source software.
2021-01-12 23:08:31 +08:00
* [https://github.com/golang/go](https://github.com/golang/go) `BSD-3-Clause License`
* [https://github.com/vanng822/css](https://github.com/vanng822/css) `MIT License`
* [https://github.com/88250/gulu](https://github.com/88250/gulu) `Mulan PSL v2`
* [https://github.com/olahol/melody](https://github.com/olahol/melody) `BSD-2-Clause License`
* [https://github.com/Masterminds/sprig](https://github.com/Masterminds/sprig) `MIT License`
* [https://github.com/Xuanwo/go-locale](https://github.com/Xuanwo/go-locale) `Apache-2.0 License`
* [https://github.com/blastrain/vitess-sqlparser](https://github.com/blastrain/vitess-sqlparser) `Apache-2.0 License`
* [https://github.com/common-nighthawk/go-figure](https://github.com/common-nighthawk/go-figure) `MIT License`
* [https://github.com/dustin/go-humanize](https://github.com/dustin/go-humanize) `MIT License`
* [https://github.com/emirpasic/gods](https://github.com/emirpasic/gods) `BSD-2-Clause License`
* [https://github.com/facette/natsort](https://github.com/facette/natsort) `BSD-3-Clause License`
* [https://github.com/fsnotify/fsnotify](https://github.com/fsnotify/fsnotify) `BSD-3-Clause License`
* [https://github.com/gin-gonic/gin](https://github.com/gin-gonic/gin) `MIT License`
* [https://github.com/jackpal/gateway](https://github.com/jackpal/gateway) `BSD-3-Clause License`
* [https://github.com/mitchellh/go-ps](https://github.com/mitchellh/go-ps) `MIT License`
* [https://github.com/mssola/user_agent](https://github.com/mssola/user_agent) `MIT License`
* [https://github.com/panjf2000/ants](https://github.com/panjf2000/ants) `MIT License`
* [https://github.com/parnurzeal/gorequest](https://github.com/parnurzeal/gorequest) `MIT License`
* [https://github.com/microsoft/TypeScript](https://github.com/microsoft/TypeScript) `Apache-2.0 License`
* [https://github.com/electron/electron](https://github.com/electron/electron) `MIT License`
2021-04-28 23:34:10 +08:00
* [https://github.com/visjs/vis-network](https://github.com/visjs/vis-network) `Apache-2.0 License`
2021-01-12 23:08:31 +08:00
* [https://github.com/google/diff-match-patch](https://github.com/google/diff-match-patch) `Apache-2.0 License`
* [https://github.com/rtfpessoa/diff2html](https://github.com/rtfpessoa/diff2html) `MIT License`
* [https://github.com/mozilla/pdfjs-dist](https://github.com/mozilla/pdfjs-dist) `Apache-2.0 License`
* [https://github.com/blueimp/JavaScript-MD5](https://github.com/blueimp/JavaScript-MD5) `MIT License`
* [https://github.com/fex-team/kityminder-core](https://github.com/fex-team/kityminder-core) `BSD-3-Clause License`
2021-05-14 22:55:14 +08:00
* [https://github.com/hakimel/reveal.js](https://github.com/hakimel/reveal.js) `MIT License`