Markopolis:提供 Markdown 文件的 Web 应用

a year ago

什么是 Markopolis ?

Markopolis 是一款旨在提供 Markdown 文件的 Web 应用和 API 服务器。它允许您以网站形式共享 Markdown 笔记,并使用 API 与 Markdown 文件交互和操作它们。类似于 Obsidian Publish,但又不会被锁定在 Obsidian 生态系统中。

软件特点:

REST API 接口: 提供 REST API 来与笔记中的不同 Markdown 元素进行交互。 可定制的 UI: 通过使用 Markopolis 作为后端,支持“自带用户界面”。 Obsidian Markdown 风格: 接近 Obsidian Markdown 风格并支持反向链接、待办事项和 LaTeX 方程式。 即时渲染: 使用单个命令将 Markdown 笔记推送到服务器,并立即将其渲染为简单的网页。 全文搜索: 实现全文搜索。 暗色和亮色模式: 支持暗色和亮色模式。 代码格式和待办事项: 支持代码格式和待办事项。 低维护: 几乎不需要维护。 API 文档: 使用 FastAPI 生成的内置 API 文档。

https://appstore.lazycat.cloud/#/shop/detail/wcloud.gblw.app.markopolis

如何使用

应用安装之后,默认打开首页,内置了几个文件

image.png

从懒猫网盘里,可以看到多了一个markopolis/data文件夹,文档都在这里面

image.png

只要把文件放到这个目录下,就能看到数据了 但是这里要注意,md文件名字,不能有特殊符号,比如-,这样数据就出不来,会报错

image.png

md文件必须以这样开头,否则文件还是读取不来,ID、Title、Tags必须有,具体值自己可以改

ID: 1c Title: 深度学习简介 Tags: #人工智能 #机器学习

举例:

image.png

展示出来就是这种效果

image.png

如果你想自己开发,对接服务端,可以这样,在域名后加上/docs

image.png

比如第一个hello world image.png

通过应用查看器,拿到key的值

https://appstore.lazycat.cloud/#/shop/detail/top.j0k3r.lpk-inspector

image.png

填入这个值vCUJvtcnsJPxPUHZzNWNquHMzxEYEqoCWEXuwnEBaFFCtduhhTTsmwRKxWHGFvdG,点击执行

image.png

看到状态是200,返回了结果hello world,说明接口是通的

image.png

这样你就可以自己写个接口,调用api,直接把数据推送到服务端就行了。

image.png

网盘能直接看到 image.png

同理,用接口创建的md,内容也要符合规则,否则还是会出现解析失败的情况。

以上就是markopolis的基本用法,可以作为一个不错的markdown查看器。

作者
天天