Markor
文本编辑器 - 笔记和待办事项(适用于 Android)。简单轻量,支持 Markdown、todo.txt、Zim 等多种格式!
Markor 是一款 Android 文本编辑器。 这个项目旨在打造一个多功能、灵活且轻量的编辑器。 Markor 利用简单的标记格式如 Markdown 和 todo.txt 来进行笔记记录和列表管理。 它在处理文本方面非常versatile;也可用于保存书签、复制到剪贴板、快速打开文本中的链接等多种用途。 创建的文件可与任何平台上的其他纯文本软件互操作。 Markor 是一个开放开发的自由软件,接受社区贡献。
功能
📝 使用简单的标记格式创建笔记并管理待办事项列表
🌲 完全离线工作 -- 随时随地
👌 与任何平台上的其他纯文本软件兼容 -- 用记事本或 vim 编辑,用 grep 过滤,转换为 PDF 或创建 zip 归档
🖍 语法高亮和格式相关操作 -- 快速插入图片和待办事项
👀 将文档转换、预览和分享为 HTML 和 PDF
📚 笔记本:将所有文档存储在一个公共文件系统文件夹中
📓 快速笔记:快速访问以保存笔记
☑️ 待办事项:写下你的待办事项
🖍 格式:Markdown、todo.txt、Zim/WikiText、纯文本、csv、ics、ini、json、toml、vcf、yaml
📋 复制到剪贴板:复制任何文本,包括分享到 Markor 的文本
💡 笔记本是文档的根文件夹,可以更改为文件系统上的任何位置。快速笔记和待办事项是文本文件
🎨 高度可定制,提供深色主题
💾 自动保存,支持撤销/重做选项
👌 无广告或不必要的权限
🌎 语言选择 -- 使用与系统不同的语言
🔃 Markor 是一款离线应用。它可以与同步应用一起使用,但同步需要由相应的应用完成。
🔒 可以使用 AES256 加密你的文本文件。你需要在设置中设置密码,并使用 Marshmallow 或更新版本的 Android 设备。你可以使用 jpencconverter 在桌面上进行加密/解密。请注意,只有文本被加密,图片或附件不会被加密。
最新更新中的新功能 - Markor v2.11 - AsciiDoc、CSV 和 Org-Mode、Todo.txt 高级搜索、行号
行号支持
Markor 现在支持显示行号。在顶部文件菜单中,你可以找到一个新选项来启用行号。 这在编辑器和文档的查看模式(在代码块中)都得到支持。
新格式:AsciiDoc
AsciiDoc 是现在支持的新格式之一。 虽然它可能不如 Markdown 那样完善,但应该足以满足一般使用需求。
新格式:CSV
现在支持 CSV 文件(在语法高亮和预览方面)。 详情请参见 CSV README,它在 #1988、#1987、#1980、#1667 中实现。
- 带有语法高亮器的编辑器
- 每个 CSV 列以不同的唯一颜色显示,以便查看哪些 CSV 数据属于哪个列/标题
- 以 HTML 表格预览,可导出为 PDF
- CSV 列可以包含 Markdown(参见截图中的示例列)
新格式:Org-Mode
第三个也是最后一个新添加的格式是 Org-Mode。请注意,目前只有编辑器语法高亮和用于简化编辑的操作按钮可用。 尚未实现专门的查看模式。
导航
- README
- 常见问题
- 更多
- 新闻
- Markor v2.11 - AsciiDoc、CSV和Org-Mode、Todo.txt高级搜索
- Markor v2.10 - 自定义文件模板,分享时自动移除URL跟踪参数
- Markor v2.9 - 代码片段、模板、图表、图形、图表、YAML前置元数据、化学
- Markor v2.8 - todo.txt对话框多选功能
- Markor v2.7 - 内容搜索、设置备份与恢复
- Markor v2.6 - Zim Wiki、换行=新段落、保存格式
- Markor v2.5 - Zim Wiki - 搜索与替换 - Zettelkasten
- Markor v2.4 - 全新todo.txt - 编程语言语法高亮
- Markor v2.3 - 目录、自定义操作顺序
- Markor v2.2 - 演示文稿、语音笔记、Markdown表格编辑器
- Markor v2.1 - 键值高亮(json/ini/yaml/csv)、性能提升
- Markor v2.0 - 搜索、dotFiles、PDF导出
- Markor v1.8 - 全新文件浏览器、收藏夹和更快的Markdown预览
- Markor v1.7 - 自定义字体、带Markdown的LinkBox
- Markor v1.6 - 日期时间对话框 - Jekyll和KaTex改进
- Markor v1.5 - 多窗口、Markdown任务、主题
- Markor v1.2 - 带KaTex/Math的Markdown - 当前文档搜索
- Markor v1.1 - 从图库和相机导入Markdown图片
- Markor v1.0 - LinkBox、ToDo、QuickNote的小部件快捷方式
- Markor v0.3 - 更快加载、添加LinkBox、在浏览器中打开链接的文本操作
贡献
- 编程
该项目始终欢迎贡献和合并请求。请查看我们的问题追踪器以了解开放的问题,特别是"适合新手的问题"。 - 功能请求与讨论
在这里开始讨论。 - 错误报告
在这里报告问题。请先搜索类似的问题和请求。如果不是bug,请前往讨论区。 - 本地化
在Crowdin上进行翻译(免费)。
开发
使用git克隆项目。然后在Android Studio(推荐)中打开项目,安装所需的Android SDK依赖。 您也可以使用任何其他您喜欢的纯文本编辑器。
项目中有一个Makefile,可以方便地测试、检查、构建、安装和在您的设备上运行应用程序。请参阅Makefile以了解详情。
您可以在dist/目录中找到二进制文件(.apk)、日志、测试结果和其他输出。
示例:make all install run
。
项目代码风格遵循AOSP Java代码风格。在提交或创建拉取请求之前,请使用Android Studio的"自动重新格式化"菜单选项。
技术/依赖
- Java、Android SDK、AndroidX
- 不依赖NDK,1个APK = 所有Android支持的架构
- 编辑器:基于Android EditText的高级组件
- 预览:Android WebView
- 编辑器语法高亮:所有支持格式的自定义实现
- Markdown解析器:flexmark-java
- Zim/WikiText解析器:自定义实现,转译为Markdown
- todo.txt解析器:自定义实现
- 二进制支持:WebView html img/audio/video,支持大多数常见格式
- CI/CD:GitHub Actions
- 构建系统:Gradle、Makefile
资源
隐私
Markor 不会使用您的互联网连接,除非您自己生成的内容引用了外部资源(例如,当您通过 URL 引用外部图片时)。 该应用完全离线工作,无需互联网连接! 不会与作者或任何第三方共享个人数据。 通过点击应用内的分享按钮,可以将文件分享到其他应用。 文件存储在用户可选择的文件夹中,默认为内部存储的"Documents"目录。
Android 权限
- WRITE_EXTERNAL_STORAGE, READ_EXTERNAL_STORAGE
读取和写入存储中的文件。 - INTERNET
在用户生成的内容中可以从互联网加载数据。 - INSTALL_SHORTCUT
在启动器中安装快捷方式以在 Markor 中打开文件/文件夹。 - RECORD_AUDIO
为文本附加语音笔记。该权限仅在点击"附加音频"按钮后的音频记录对话框中使用。音频录制始终由您手动启动和停止(按钮按下)。
许可证
应用程序的代码采用 Apache 2.0 许可。
本地化和翻译文件(string*.xml)以及示例采用 CC0 1.0(公共领域)许可。
项目基于未维护的 writeily 和 writeily-pro 项目。
常见问题
文件浏览器和文件管理
如何保存文件?
当您离开 Markor 或关闭文件时,Markor 会自动保存文本。此外,顶部菜单中还有一个保存按钮。
如何将文件保存到 SD 卡?
浏览到 SD 卡的起始文件夹,然后按 + 按钮(使用文件浏览器或菜单选项)。现在按加号按钮并按照对话框中的步骤操作。之后,Markor 的文件浏览器将不再划掉文件名,文件将变为可写。
如何同步文件?
Markor 是并将继续是一个注重离线使用的应用程序。它可以与同步应用程序配合使用,这些应用程序负责处理同步。
已知可以与 Markor 配合使用的同步客户端包括 BitTorrent Sync、Dropbox、FolderSync、OwnCloud、NextCloud、Seafile、Syncthing、Syncopoli 等。
项目推荐使用 Syncthing。-> Syncthing 指南
什么是笔记本?
您文件的根文件夹!Markor 在主屏幕上从这个文件夹开始,允许您浏览文件。您可以在 Markor 中使用任何(可访问的)文件和位置。
什么是待办事项?
您的主要待办事项列表文件,采用 todo.txt 格式。您可以通过在主屏幕上滑动一次,在笔记本中选择 todo.txt,或使用专用启动器来访问它。您还可以从笔记本或其他应用程序中打开它!当文本只有一行时,在将文本分享到 Markor 时,您还可以选择创建待办事项任务。此文件的位置可以自由选择,独立于笔记本目录。
什么是快速笔记?
最快速和最简单的记笔记方式!快速笔记是一个 Markdown 格式的文件,文件位置可以自由选择。您可以通过在主屏幕上滑动两次,在笔记本中选择快速笔记,或使用专用启动器来访问它。此文件的位置可以自由选择,独立于笔记本目录。
启动器
启动器是设备启动器(=应用抽屉/开始菜单)中的"开始菜单选项"。安装 Markor 后,您会在开始菜单中看到 Markor 的选项。当启用 Markor 设置选项"启动器(特殊文档)"时,您会获得待办事项和快速笔记的额外开始菜单选项。请注意,更改此选项后需要重新启动设备。
格式:Markdown
什么是 Markdown?
一种适用于各种文档的通用标记格式。由于 Markdown 在显示渲染视图之前会转换为 HTML,因此您还可以在文本中包含 HTML,从而可以实现网络浏览器能做的一切。
CommonMark 是 Markor 中使用的 Markdown 解析器实现的规范。
资源 | |
---|---|
CommonMark 教程 | 10 分钟学习 Markdown |
CommonMark 帮助 | 学习 Markdown 的快速参考和交互式教程。 |
CommonMark 规范 | CommonMark Markdown 规范 |
daringfireball | Markdown 创建者的语法文档 |
包含空格的文件链接
大多数 Markdown 应用程序使用 URL 编码处理链接,Markor 也是如此。这意味着将每个空格
替换为%20
。这确保了您的 Markdown 内容与大多数其他 Markdown 应用程序兼容。
Markor 有一个专门用于添加链接和文件引用的按钮,它会自动应用适当的格式。查看这个视频了解文件引用按钮的位置和使用方法。
示例:[alt](my cool file.md)
⮕ [alt](my%20cool%20file.md)
。
我可以在课堂上使用 Markor 写方程吗?(数学)
是的,Markor 具有高级数学功能!通过勾选设置»格式»Markdown»数学来启用此功能。
Markor 的 markdown-reference.md 模板(可从新建文件对话框中获取)展示了一些示例。
在这里了解更多可用函数和符号:1,2
格式:todo.txt
什么是 todo.txt?
Todo.txt 是一种简单的待办事项文本格式。每行文本都是一个任务。这个想法来自 Gina Trapani。
如何标记任务完成?
已完成的任务在行首标记为 x
,可以选择将其移动到已完成/归档文件中。
什么是上下文(@)?
使用上下文可以标记情况或地点。您可以用它来对待办事项进行分类。上下文是 todo.txt 格式的一部分,在单词前加上 @
即可创建。
示例:@home @work
什么是项目(+)?
使用项目可以按特定项目对任务进行分组。您可以用它来为待办事项添加可识别的元信息标签。项目是 todo.txt 格式的一部分,在单词前加上 +
即可创建。
示例:+video +download +holidayPlanning