Markopolis：提供 Markdown 文件的 Web 应用

## 什么是 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](https://dl.playground.lazycat.cloud/guidelines/496/72dff488-3f10-45ec-a3a9-056ef58749bb.png "image.png")

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

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/647f52e7-704a-4370-b6d2-8e63941d3c23.png "image.png")

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

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/6bf28bcd-d43a-4cfb-b613-999c0e00bbda.png "image.png")

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

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

举例：

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/f6600994-8869-4c81-a698-98f916f019bf.png "image.png")

展示出来就是这种效果

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/00a465ab-3e22-4cce-b2b3-3e63ca84fdbd.png "image.png")

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

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/c930fc7e-afe9-47db-8b47-74bdb7f672b7.png "image.png")

比如第一个hello world
![image.png](https://dl.playground.lazycat.cloud/guidelines/496/2432c318-cef2-4d75-a8c6-163da5b6bddc.png "image.png")

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


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


![image.png](https://dl.playground.lazycat.cloud/guidelines/496/02511676-5ee0-4ada-8a32-5e62076bd9e4.png "image.png")

填入这个值vCUJvtcnsJPxPUHZzNWNquHMzxEYEqoCWEXuwnEBaFFCtduhhTTsmwRKxWHGFvdG，点击执行

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/9e24a065-6bff-43e7-8c15-17eaabafc8f7.png "image.png")

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

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/5074a2ee-0253-4d3d-97e8-efd5a9d02e9e.png "image.png")

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

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/b9b347e0-c329-4353-9e98-c670d021a695.png "image.png")

网盘能直接看到
![image.png](https://dl.playground.lazycat.cloud/guidelines/496/a16643c0-a7a1-4da9-9d5b-f0aabe82c7ee.png "image.png")

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

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