siyuan/README.md

143 lines
6 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>
<em>源于思考,饮水思源</em>
<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="Release Date" target="_blank" href="https://github.com/siyuan-note/siyuan/releases"><img src="https://img.shields.io/github/release-date/siyuan-note/siyuan.svg?style=flat-square&color=99CCFF"></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>
2020-12-28 09:30:34 +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?style=flat-square&color=FF96B4"></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">
<a href="https://github.com/siyuan-note/siyuan/blob/master/README_en_US.md">English</a>
</p>
2020-08-30 23:47:52 +08:00
2020-09-10 16:01:59 +08:00
## 💡 简介
2020-10-03 19:26:05 +08:00
思源笔记是一款 Markdown 块级引用和双向链接的网状笔记应用,支持 Windows、Mac 和 Linux可在浏览器上直接使用支持移动端适配。
2020-09-10 16:01:59 +08:00
2020-11-01 11:48:51 +08:00
在线体验:[https://ld246.com/xanadu/](https://ld246.com/xanadu/),欢迎到[思源笔记官方讨论区](https://ld246.com/tag/siyuan)了解更多。
2020-09-10 16:01:59 +08:00
2021-01-12 17:18:11 +08:00
![desktop.png](https://cdn.jsdelivr.net/gh/siyuan-note/siyuan@2a5378647a479d10f330daf59d3eb1649473a404/screenshots/desktop.png)
2020-10-06 09:22:23 +08:00
2021-01-12 17:18:11 +08:00
![mobile.png](https://cdn.jsdelivr.net/gh/siyuan-note/siyuan@2a5378647a479d10f330daf59d3eb1649473a404/screenshots/mobile.png)
2020-10-06 09:22:23 +08:00
2020-09-10 16:01:59 +08:00
## ✨ 特性
2020-11-21 09:42:22 +08:00
* 为 Markdown 而生
* 类似 Typora 的即时渲染编辑模式
2020-09-10 16:01:59 +08:00
* 支持数学公式、图表、流程图、甘特图、时序图、五线谱等
* 粘贴 HTML 自动转换为 Markdown
* 配置 Markdown 解析渲染细节参数
2020-09-23 20:21:49 +08:00
* 内容块
* 块级引用和双向链接
* 文档关系图、全局关系图
* 书签收藏
2020-11-19 08:56:17 +08:00
* 动态查询嵌入
2021-01-12 10:37:29 +08:00
* 提供 URL 浏览器访问或给其他软件链接
* 脑图模式
* 支持缩放、拖拽、布局、主题等
* 编辑和 Markdown 保持同步
* 支持浏览器使用、支持移动端
2020-09-27 09:23:46 +08:00
* 层级标签
* 多窗口多页签,拖拽分屏
* WebDAV
2020-11-19 09:04:21 +08:00
* 版本管理和同步
2020-09-10 16:01:59 +08:00
* 全文搜索
2020-09-23 20:21:49 +08:00
* 主题和图标
* 内置明亮、暗黑两套主题
* 内置 Material、Ant Design 两套图标
2020-09-23 20:26:09 +08:00
* 支持自定义主题和图标
2020-09-23 20:21:49 +08:00
* 导出
2021-01-12 10:52:44 +08:00
* 标准 Markdown 和 TextBundle 导出
2020-09-23 20:21:49 +08:00
* 内容块引用提供锚文本 + 嵌入 Blockquote 选项
* 复制到微信公众号、知乎
2020-11-19 09:04:21 +08:00
* 在线工作空间
* 在线分享发布
2020-08-30 23:49:14 +08:00
2020-09-10 16:16:53 +08:00
## 🗺️ 路线图
2020-09-03 11:46:50 +08:00
* [思源笔记开发计划和进度](https://github.com/siyuan-note/siyuan/projects/1)
* [思源笔记版本变更记录](https://github.com/siyuan-note/siyuan/blob/master/CHANGE_LOGS.md)
2020-09-03 23:13:25 +08:00
2020-09-10 16:01:59 +08:00
## 📸 截图
### 即时渲染
*即时渲染*模式对熟悉 Typora 的用户应该不会感到陌生,理论上这是最优雅的 Markdown 编辑方式。
2021-01-12 17:18:11 +08:00
![ir-block](https://cdn.jsdelivr.net/gh/siyuan-note/siyuan@2a5378647a479d10f330daf59d3eb1649473a404/screenshots/ir-block.gif)
2021-01-12 09:22:51 +08:00
### 块移动、折叠和样式
2021-01-12 17:18:11 +08:00
![move-fold-style](https://cdn.jsdelivr.net/gh/siyuan-note/siyuan@2a5378647a479d10f330daf59d3eb1649473a404/screenshots/move-fold-style.gif)
2020-09-10 16:01:59 +08:00
2021-01-12 10:37:29 +08:00
### 脑图模式
2021-01-12 17:18:11 +08:00
![mindmap](https://cdn.jsdelivr.net/gh/siyuan-note/siyuan@2a5378647a479d10f330daf59d3eb1649473a404/screenshots/mindmap.png)
2021-01-12 10:37:29 +08:00
2020-09-10 16:01:59 +08:00
### 漫游
2021-01-12 17:18:11 +08:00
![roam.gif](https://cdn.jsdelivr.net/gh/siyuan-note/siyuan@2a5378647a479d10f330daf59d3eb1649473a404/screenshots/roam.gif)
2020-09-10 16:01:59 +08:00
2020-10-06 09:46:24 +08:00
### 设置
2020-09-10 16:01:59 +08:00
2021-01-12 17:18:11 +08:00
![settings.png](https://cdn.jsdelivr.net/gh/siyuan-note/siyuan@2a5378647a479d10f330daf59d3eb1649473a404/screenshots/settings.png)
2020-09-10 16:01:59 +08:00
2020-09-10 16:31:01 +08:00
### 搜索
2020-09-10 16:01:59 +08:00
2021-01-12 17:18:11 +08:00
![search.png](https://cdn.jsdelivr.net/gh/siyuan-note/siyuan@2a5378647a479d10f330daf59d3eb1649473a404/screenshots/search.png)
2020-09-10 16:31:01 +08:00
2020-09-10 16:01:59 +08:00
### 块级引用
2021-01-12 17:18:11 +08:00
![blockref.png](https://cdn.jsdelivr.net/gh/siyuan-note/siyuan@2a5378647a479d10f330daf59d3eb1649473a404/screenshots/block-ref.gif)
2020-09-10 16:01:59 +08:00
2020-11-19 08:54:13 +08:00
### 动态查询嵌入
2021-01-12 17:18:11 +08:00
![block-query-embed.png](https://cdn.jsdelivr.net/gh/siyuan-note/siyuan@2a5378647a479d10f330daf59d3eb1649473a404/screenshots/block-query-embed.gif)
2020-11-19 08:54:13 +08:00
2021-01-12 17:17:13 +08:00
### 社区主题集市
2021-01-12 17:18:11 +08:00
![theme-bazaar](https://cdn.jsdelivr.net/gh/siyuan-note/siyuan@2a5378647a479d10f330daf59d3eb1649473a404/screenshots/theme-bazaar.png)
2021-01-12 17:17:13 +08:00
2020-09-10 16:04:41 +08:00
## 🛠️ 下载安装
2020-09-10 16:01:59 +08:00
* [GitHub](https://github.com/siyuan-note/siyuan/releases)
* [码云](https://gitee.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
## 📜 文档
2020-12-28 09:30:34 +08:00
* [思源笔记用户指南](https://ld246.com/udanax/1602224134353)
2020-09-10 16:01:59 +08:00
* [思源笔记 - 支持 Markdown 块级引用和双向链接的网状笔记应用](https://ld246.com/article/1598872180233)
* [Markdown 实现块级引用双向链接的探索](https://ld246.com/article/1597226949061)
## 🏘️ 社区
* [思源笔记 Issues](https://github.com/siyuan-note/siyuan/issues)
* [思源笔记讨论区](https://ld246.com/tag/siyuan)
* [思源笔记 QQ 群](https://jq.qq.com/?_wv=1027&k=brIyNm7y)
2020-11-30 10:09:45 +08:00
* [思源笔记客服邮箱](mailto:support@b3log.org)
2020-11-30 10:11:20 +08:00
* 微信公众号:`B3log开源`
2020-11-30 10:09:45 +08:00
![b3logos.jpg](https://b3logfile.com/file/2020/08/b3logos-032af045.jpg)
2020-09-03 23:13:25 +08:00
2020-09-10 16:01:59 +08:00
## 🙏 鸣谢
2020-09-03 23:13:25 +08:00
2020-09-10 16:01:59 +08:00
* [浏览器端的编辑器 Vditor](https://github.com/Vanessa219/vditor)
* [对中文语境优化的 Markdown 引擎 Lute](https://github.com/88250/lute)
* [Go WebDAV 客户端库](https://github.com/88250/gowebdav)
* [Go 常用工具库](https://github.com/88250/gulu)
2020-11-19 08:54:13 +08:00
* [Go WebSocket 框架 melody](https://github.com/88250/melody)
2020-09-10 16:01:59 +08:00
* [Go Web 框架 Gin](https://github.com/gin-gonic/gin)
* [跨平台桌面应用框架 Electron](https://github.com/electron/electron)
2020-12-12 23:48:56 +08:00
## 💌 参与贡献
目前思源笔记的一些组件是开源的,欢迎参与贡献。
* [用户指南](https://github.com/siyuan-note/user-guide-zh_CN)
* [外观和语言](https://github.com/siyuan-note/appearance)
* [Markdown 引擎](https://github.com/88250/lute)