PyPI - zarkdown - Versions diffs - 2.0.1__tar.gz - Mend

zarkdown 2.0.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

zarkdown-2.0.1/PKG-INFO +187 -0
zarkdown-2.0.1/README.md +174 -0
zarkdown-2.0.1/pyproject.toml +26 -0
zarkdown-2.0.1/setup.cfg +4 -0
zarkdown-2.0.1/src/zarkdown/__init__.py +0 -0
zarkdown-2.0.1/src/zarkdown/core.py +607 -0
zarkdown-2.0.1/src/zarkdown.egg-info/PKG-INFO +187 -0
zarkdown-2.0.1/src/zarkdown.egg-info/SOURCES.txt +9 -0
zarkdown-2.0.1/src/zarkdown.egg-info/dependency_links.txt +1 -0
zarkdown-2.0.1/src/zarkdown.egg-info/entry_points.txt +2 -0
zarkdown-2.0.1/src/zarkdown.egg-info/top_level.txt +1 -0

zarkdown-2.0.1/PKG-INFO ADDED Viewed

@@ -0,0 +1,187 @@
+Metadata-Version: 2.4
+Name: zarkdown
+Version: 2.0.1
+Summary: Zarkdown - 键盘友好型纯文本标记语言
+Author-email: yangzizhoudiwuxuande <yangzizhou2026@outlook.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yangzizhoudiwuxuande/zarkdown
+Project-URL: Bug Tracker, https://github.com/yangzizhoudiwuxuande/zarkdown/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+# ✨ Zarkdown （版本2.0.1）
+> **键盘友好型纯文本标记语言** —— 所有符号均位于键盘主键区，无需按 Shift 组合键。
+[![Python Version](https://img.shields.io/badge/python-3.6+-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/yangzizhoudiwuxuande/zarkdown)](https://github.com/yangzizhoudiwuxuande/zarkdown/stargazers)
+Zarkdown 是一种全新的纯文本标记语言，专为**快速写作**和**极致键盘效率**而设计。它适合用来写笔记、技术文档、博客文章，甚至可以作为配置文件的格式。
+---
+## 🎯 设计哲学
+- **键盘友好**：所有语法符号都在主键区，手指不需要大范围移动
+- **直观易记**：`/` 表示标题（像路径层级），`?` 表示加粗（像强调语气）
+- **纯文本**：任何文本编辑器都能打开，人类可读性强
+- **可扩展**：支持表格、代码块、脚注等高级功能
+---
+## 📜 完整语法表
+| 效果 | 语法 | 示例 | 渲染为 |
+| :--- | :--- | :--- | :--- |
+| **标题 1~4 级** | `/` `//` `///` `////` + 空格 | `/ 大标题` | `<h1>`~`<h4>` |
+| **粗体** | `?文字?` | `?重要?` | `<strong>` |
+| **斜体** | `\文字\` | `\斜体\` | `<i>` |
+| **删除线** | `-文字-` | `-删掉-` | `<del>` |
+| **超链接** | `*文字*(链接)` | `*点击*(https://x.com)` | `<a>` |
+| **图片** | `$图片名$(链接)` | `$logo$(./pic.png)` | `<img>` |
+| **行内代码** | `~文字~` | `~npm i~` | `<code>` |
+| **多行代码块** | `~语言` 开头 + `~` 结尾 | `~python`...`~` | `<pre><code>` |
+| **无序列表** | `!文字`（行首） | `!苹果` | `<ul><li>` |
+| **有序列表** | `•文字`（行首，U+2022） | `•第一` | `<ol><li>` |
+| **引用** | `\|文字`（行首） | `\| 引文` | `<blockquote>` |
+| **表格** | `\| 表头 \|` + `------` | 见下方示例 | `<table>` |
+| **注释** | `<文字>`（不含URL） | `<备注>` | `<!-- -->` |
+| **脚注** | `[数字]<文字>` | `[1]<说明>` | `<sup title="">` |
+| **分割线** | `-----`（独占一行） | | `<hr>` |
+| **转义** | `^` 加在任意符号前 | `^/ 不是标题` | 原样输出 |
+---
+## 🚀 快速上手
+### 安装
+```bash
+# 克隆仓库
+git clone https://github.com/yangzizhoudiwuxuande/zarkdown.git
+cd zarkdown
+# 创建虚拟环境（推荐）
+python3 -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+# 安装
+pip install -e .
+```
+---
+## 使用
+```bash
+# 转换 .zkdn 文件为 .html
+zarkdown example.zkdn -o example.html
+# 直接输出到终端（不生成文件）
+zarkdown example.zkdn
+```
+---
+## 示例
+### 转为HTML
+创建一个`hello.zkdn`文件：
+```zkdn
+/ Zarkdown 欢迎页
+?恭喜?，您的格式已经跑通了！
+这里有一个链接：*点击访问*(https://github.com/yangzizhoudiwuxuande)
+~python
+print("Hello Zarkdown!")
+~
+```
+然后运行：
+```bash
+zarkdown hello.zkdn -w
+```
+浏览器会自动打开，显示渲染后的 HTML 页面。修改 `hello.zkdn` 并保存，页面会自动刷新。
+### 转为Word/LaTex
+转为Word/LaTex需要安装Pandoc。
+```bash
+brew install pandoc
+```
+转为Word
+```bash
+zarkdown my_note.zkdn -f docx
+```
+转为LaTex
+```bash
+zarkdown my_note.zkdn -f latex
+```
+## 📸 效果预览
+[![pm4y4lF.png](https://s41.ax1x.com/2026/08/01/pm4y4lF.png)](https://imgchr.com/i/pm4y4lF)
+## 贡献
+欢迎任何形式的贡献！你可以：
+* 🐛 报告 Bug（在 Issues 中描述）
+* 💡 提出新功能建议
+* 📝 完善文档
+* 🔧 提交 Pull Request
+## 📄 许可证
+本项目采用 MIT License 开源协议，你可以自由使用、修改、分发。
+## ❤️ 致谢
+感谢你阅读这份文档！如果觉得 Zarkdown 有趣，欢迎给项目点一颗 ⭐ 星，让更多人看到它。
+## 📝 更新日志
+**v2.0.1 (2026-08-01)**
+- **语法错误检查器**
+  转换前自动扫描全文，检测未闭合的成对符号（`?`、`\`、`-`、`~`、`*`、`$`、`[`、`<`），并精确报告行号和列号，帮助用户快速定位问题。
+- **括号配对检查**
+  针对超链接 `*文字*(链接)` 和图片 `$图片名$(链接)`，自动检测缺失的闭合括号 `)`，避免生成无效链接。
+- **多行表格支持**
+  表格单元格内允许换行，通过缩进续行自动合并内容，并在输出中转换为 `<br>` 换行符。
+- **转义字符 `^`**
+  在任意特殊符号前添加 `^` 即可原样输出，避免被解析器处理，例如 `^/ 不是标题`。
+- **智能跳过机制**
+  错误检查器自动跳过分割线（以 `-----` 开头的行）、表格分隔行以及多行代码块内部内容，避免误报。
+- **自动生成输出文件名**
+  若不指定 `-o`，输出文件名将根据输入文件名和格式自动生成（如 `note.html`、`note.pdf` 等）。
+**v2.0.0 (2026-07-28)**
+* 支持导出为Word/LaTex等格式（需安装Pandoc）
+**v1.2.2 (2026-07-26)**
+* 支持多行表格
+**v1.2.1 (2026-07-26)**
+* 支持嵌套语法（粗体里套斜体、超链接里套粗体等）
+**v1.2.0 (2026-07-25)**
+* 使引用和表格变得更好看
+**v1.1.0 (2026-07-25)**
+* ✨ 新增 `-w` 监听模式，保存即自动重新转换
+* ✨ 自动在浏览器中打开生成 HTML，实现实时预览
+* 🐛 修复中文编码问题，兼容带 BOM 的 UTF-8 文件
+* 🐛 修复 macOS 下相对路径打开失败的问题
+* 📝 完善 README 文档，增加完整语法表和示例
+**v1.0.0 (2026-07-25)**
+* 🎉 首次发布，支持完整的 Zarkdown 语法
+---
+Happy Writing with Zarkdown!
+## 联系
+yangzizhou2026@outlook.com

zarkdown-2.0.1/README.md ADDED Viewed

@@ -0,0 +1,174 @@
+# ✨ Zarkdown （版本2.0.1）
+> **键盘友好型纯文本标记语言** —— 所有符号均位于键盘主键区，无需按 Shift 组合键。
+[![Python Version](https://img.shields.io/badge/python-3.6+-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/yangzizhoudiwuxuande/zarkdown)](https://github.com/yangzizhoudiwuxuande/zarkdown/stargazers)
+Zarkdown 是一种全新的纯文本标记语言，专为**快速写作**和**极致键盘效率**而设计。它适合用来写笔记、技术文档、博客文章，甚至可以作为配置文件的格式。
+---
+## 🎯 设计哲学
+- **键盘友好**：所有语法符号都在主键区，手指不需要大范围移动
+- **直观易记**：`/` 表示标题（像路径层级），`?` 表示加粗（像强调语气）
+- **纯文本**：任何文本编辑器都能打开，人类可读性强
+- **可扩展**：支持表格、代码块、脚注等高级功能
+---
+## 📜 完整语法表
+| 效果 | 语法 | 示例 | 渲染为 |
+| :--- | :--- | :--- | :--- |
+| **标题 1~4 级** | `/` `//` `///` `////` + 空格 | `/ 大标题` | `<h1>`~`<h4>` |
+| **粗体** | `?文字?` | `?重要?` | `<strong>` |
+| **斜体** | `\文字\` | `\斜体\` | `<i>` |
+| **删除线** | `-文字-` | `-删掉-` | `<del>` |
+| **超链接** | `*文字*(链接)` | `*点击*(https://x.com)` | `<a>` |
+| **图片** | `$图片名$(链接)` | `$logo$(./pic.png)` | `<img>` |
+| **行内代码** | `~文字~` | `~npm i~` | `<code>` |
+| **多行代码块** | `~语言` 开头 + `~` 结尾 | `~python`...`~` | `<pre><code>` |
+| **无序列表** | `!文字`（行首） | `!苹果` | `<ul><li>` |
+| **有序列表** | `•文字`（行首，U+2022） | `•第一` | `<ol><li>` |
+| **引用** | `\|文字`（行首） | `\| 引文` | `<blockquote>` |
+| **表格** | `\| 表头 \|` + `------` | 见下方示例 | `<table>` |
+| **注释** | `<文字>`（不含URL） | `<备注>` | `<!-- -->` |
+| **脚注** | `[数字]<文字>` | `[1]<说明>` | `<sup title="">` |
+| **分割线** | `-----`（独占一行） | | `<hr>` |
+| **转义** | `^` 加在任意符号前 | `^/ 不是标题` | 原样输出 |
+---
+## 🚀 快速上手
+### 安装
+```bash
+# 克隆仓库
+git clone https://github.com/yangzizhoudiwuxuande/zarkdown.git
+cd zarkdown
+# 创建虚拟环境（推荐）
+python3 -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+# 安装
+pip install -e .
+```
+---
+## 使用
+```bash
+# 转换 .zkdn 文件为 .html
+zarkdown example.zkdn -o example.html
+# 直接输出到终端（不生成文件）
+zarkdown example.zkdn
+```
+---
+## 示例
+### 转为HTML
+创建一个`hello.zkdn`文件：
+```zkdn
+/ Zarkdown 欢迎页
+?恭喜?，您的格式已经跑通了！
+这里有一个链接：*点击访问*(https://github.com/yangzizhoudiwuxuande)
+~python
+print("Hello Zarkdown!")
+~
+```
+然后运行：
+```bash
+zarkdown hello.zkdn -w
+```
+浏览器会自动打开，显示渲染后的 HTML 页面。修改 `hello.zkdn` 并保存，页面会自动刷新。
+### 转为Word/LaTex
+转为Word/LaTex需要安装Pandoc。
+```bash
+brew install pandoc
+```
+转为Word
+```bash
+zarkdown my_note.zkdn -f docx
+```
+转为LaTex
+```bash
+zarkdown my_note.zkdn -f latex
+```
+## 📸 效果预览
+[![pm4y4lF.png](https://s41.ax1x.com/2026/08/01/pm4y4lF.png)](https://imgchr.com/i/pm4y4lF)
+## 贡献
+欢迎任何形式的贡献！你可以：
+* 🐛 报告 Bug（在 Issues 中描述）
+* 💡 提出新功能建议
+* 📝 完善文档
+* 🔧 提交 Pull Request
+## 📄 许可证
+本项目采用 MIT License 开源协议，你可以自由使用、修改、分发。
+## ❤️ 致谢
+感谢你阅读这份文档！如果觉得 Zarkdown 有趣，欢迎给项目点一颗 ⭐ 星，让更多人看到它。
+## 📝 更新日志
+**v2.0.1 (2026-08-01)**
+- **语法错误检查器**
+  转换前自动扫描全文，检测未闭合的成对符号（`?`、`\`、`-`、`~`、`*`、`$`、`[`、`<`），并精确报告行号和列号，帮助用户快速定位问题。
+- **括号配对检查**
+  针对超链接 `*文字*(链接)` 和图片 `$图片名$(链接)`，自动检测缺失的闭合括号 `)`，避免生成无效链接。
+- **多行表格支持**
+  表格单元格内允许换行，通过缩进续行自动合并内容，并在输出中转换为 `<br>` 换行符。
+- **转义字符 `^`**
+  在任意特殊符号前添加 `^` 即可原样输出，避免被解析器处理，例如 `^/ 不是标题`。
+- **智能跳过机制**
+  错误检查器自动跳过分割线（以 `-----` 开头的行）、表格分隔行以及多行代码块内部内容，避免误报。
+- **自动生成输出文件名**
+  若不指定 `-o`，输出文件名将根据输入文件名和格式自动生成（如 `note.html`、`note.pdf` 等）。
+**v2.0.0 (2026-07-28)**
+* 支持导出为Word/LaTex等格式（需安装Pandoc）
+**v1.2.2 (2026-07-26)**
+* 支持多行表格
+**v1.2.1 (2026-07-26)**
+* 支持嵌套语法（粗体里套斜体、超链接里套粗体等）
+**v1.2.0 (2026-07-25)**
+* 使引用和表格变得更好看
+**v1.1.0 (2026-07-25)**
+* ✨ 新增 `-w` 监听模式，保存即自动重新转换
+* ✨ 自动在浏览器中打开生成 HTML，实现实时预览
+* 🐛 修复中文编码问题，兼容带 BOM 的 UTF-8 文件
+* 🐛 修复 macOS 下相对路径打开失败的问题
+* 📝 完善 README 文档，增加完整语法表和示例
+**v1.0.0 (2026-07-25)**
+* 🎉 首次发布，支持完整的 Zarkdown 语法
+---
+Happy Writing with Zarkdown!
+## 联系
+yangzizhou2026@outlook.com

zarkdown-2.0.1/pyproject.toml ADDED Viewed

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+[project]
+name = "zarkdown"
+version = "2.0.1"
+authors = [
+    { name = "yangzizhoudiwuxuande", email = "yangzizhou2026@outlook.com" },
+]
+description = "Zarkdown - 键盘友好型纯文本标记语言"
+readme = "README.md"
+license = { text = "MIT" }   # 使用 SPDX 表达式，代替 classifier
+requires-python = ">=3.6"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    # 移除了 License 分类器
+]
+[project.scripts]
+zarkdown = "zarkdown.core:main"   # 命令行入口点
+[project.urls]
+Homepage = "https://github.com/yangzizhoudiwuxuande/zarkdown"
+"Bug Tracker" = "https://github.com/yangzizhoudiwuxuande/zarkdown/issues"

zarkdown-2.0.1/setup.cfg ADDED Viewed

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build =
+tag_date = 0

zarkdown-2.0.1/src/zarkdown/__init__.py ADDED Viewed

File without changes

zarkdown-2.0.1/src/zarkdown/core.py ADDED Viewed

@@ -0,0 +1,607 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Zarkdown 核心转换引擎
+支持嵌套语法、转义、实时预览、多行表格、多格式导出 (HTML/PDF/DOCX/LaTeX)
+内置错误检查器（跳过代码块、分割线/表格分隔符）
+"""
+import re
+import sys
+import argparse
+import os
+import time
+import webbrowser
+# ------------------------------------------------------------
+# 可选依赖：pypandoc（用于 PDF/DOCX/LaTeX 导出）
+# ------------------------------------------------------------
+try:
+    import pypandoc
+except ImportError:
+    pypandoc = None
+# ============================================================
+# 0. 错误检查器（修复：跳过分割线/表格分隔符）
+# ============================================================
+def validate_zarkdown(text):
+    """
+    检查 Zarkdown 文本中的语法错误：
+    1. 未闭合的成对符号（? \\ - ~ * $ [ <）
+    2. 超链接/图片中缺少闭合括号 )
+    自动跳过：
+    - 多行代码块（~python ... ~）
+    - 分割线/表格分隔符（以 5 个以上 - 开头的行）
+    """
+    errors = []
+    lines = text.split('\n')
+    symmetric_pairs = {'?', '\\', '-', '~', '*', '$'}
+    asymmetric_pairs = {'[': ']', '<': '>'}
+    in_code_block = False
+    for line_num, line in enumerate(lines, start=1):
+        stripped = line.strip()
+        # ---- 检测多行代码块 ----
+        if not in_code_block:
+            if re.match(r'^~[a-zA-Z0-9_]+$', stripped):
+                in_code_block = True
+                continue
+        else:
+            if stripped == '~':
+                in_code_block = False
+                continue
+            continue  # 代码块内不检查
+        # ---- 跳过分割线和表格分隔符（以 5 个以上 - 开头） ----
+        if re.match(r'^-{5,}', stripped):
+            continue
+        # ---- 正常行检查 ----
+        stack = []
+        i = 0
+        n = len(line)
+        while i < n:
+            ch = line[i]
+            if ch == '^' and i + 1 < n:
+                i += 2
+                continue
+            if ch in symmetric_pairs:
+                if stack and stack[-1][0] == ch:
+                    stack.pop()
+                else:
+                    stack.append((ch, i + 1))
+                i += 1
+                continue
+            if ch in asymmetric_pairs:
+                stack.append((ch, i + 1))
+                i += 1
+                continue
+            if ch in asymmetric_pairs.values():
+                expected_open = {v: k for k, v in asymmetric_pairs.items()}[ch]
+                if stack and stack[-1][0] == expected_open:
+                    stack.pop()
+                else:
+                    errors.append({
+                        'line': line_num,
+                        'col': i + 1,
+                        'symbol': ch,
+                        'msg': f"多余的 '{ch}' 结束符，没有对应的起始符"
+                    })
+                i += 1
+                continue
+            i += 1
+        for sym, col in stack:
+            errors.append({
+                'line': line_num,
+                'col': col,
+                'symbol': sym,
+                'msg': f"未闭合的 '{sym}' 起始符"
+            })
+        # ---- 检查超链接/图片的括号 () ----
+        i = 0
+        n = len(line)
+        while i < n:
+            ch = line[i]
+            # 超链接模式：*文字*(
+            if ch == '*' and i + 1 < n:
+                j = i + 1
+                while j < n and line[j] != '*':
+                    if line[j] == '^' and j + 1 < n:
+                        j += 2
+                        continue
+                    j += 1
+                if j < n and line[j] == '*':
+                    if j + 1 < n and line[j + 1] == '(':
+                        k = j + 2
+                        while k < n and line[k] != ')':
+                            k += 1
+                        if k >= n:
+                            errors.append({
+                                'line': line_num,
+                                'col': j + 2,
+                                'symbol': '(',
+                                'msg': "超链接缺少闭合的 ')'"
+                            })
+                    i = j + 1
+                    continue
+                else:
+                    i += 1
+                    continue
+            # 图片模式：$图片名$(
+            if ch == '$' and i + 1 < n:
+                j = i + 1
+                while j < n and line[j] != '$':
+                    if line[j] == '^' and j + 1 < n:
+                        j += 2
+                        continue
+                    j += 1
+                if j < n and line[j] == '$':
+                    if j + 1 < n and line[j + 1] == '(':
+                        k = j + 2
+                        while k < n and line[k] != ')':
+                            k += 1
+                        if k >= n:
+                            errors.append({
+                                'line': line_num,
+                                'col': j + 2,
+                                'symbol': '(',
+                                'msg': "图片缺少闭合的 ')'"
+                            })
+                    i = j + 1
+                    continue
+                else:
+                    i += 1
+                    continue
+            i += 1
+    return errors
+def print_errors(errors):
+    """友好地打印错误信息"""
+    if not errors:
+        return
+    print("❌ 发现以下语法错误：\n")
+    for err in errors:
+        print(f"  第 {err['line']} 行，第 {err['col']} 列：{err['msg']} (符号: {err['symbol']})")
+    print(f"\n共发现 {len(errors)} 个错误，请修正后再试。")
+# ============================================================
+# 1. 转义处理（^符号）
+# ============================================================
+def escape_text(text):
+    """将 ^符号 替换为不可打印占位符"""
+    def repl(m):
+        return f'\x00ESC_{ord(m.group(1))}\x00'
+    return re.sub(r'\^([/\\?~\-*$•|!<\[\]])', repl, text)
+def unescape_text(text):
+    """恢复占位符为原字符"""
+    return re.sub(r'\x00ESC_(\d+)\x00', lambda m: chr(int(m.group(1))), text)
+# ============================================================
+# 2. 递归解析器（处理嵌套行内标记）
+# ============================================================
+class _InlineParser:
+    def __init__(self, text):
+        self.text = text
+        self.pos = 0
+        self.n = len(text)
+    def parse(self):
+        parts = []
+        while self.pos < self.n:
+            ch = self.text[self.pos]
+            if ch == '^':
+                self.pos += 1
+                if self.pos < self.n:
+                    parts.append(self.text[self.pos])
+                    self.pos += 1
+                continue
+            if ch == '?':
+                parts.append(self._parse_until('?', '<strong>', '</strong>'))
+            elif ch == '\\':
+                parts.append(self._parse_until('\\', '<i>', '</i>'))
+            elif ch == '-':
+                parts.append(self._parse_until('-', '<del>', '</del>'))
+            elif ch == '~':
+                parts.append(self._parse_until('~', '<code>', '</code>'))
+            elif ch == '*':
+                parts.append(self._parse_link())
+            else:
+                parts.append(ch)
+                self.pos += 1
+        return ''.join(parts)
+    def _parse_until(self, end_char, open_tag, close_tag):
+        self.pos += 1
+        inner_chars = []
+        while self.pos < self.n and self.text[self.pos] != end_char:
+            ch = self.text[self.pos]
+            if ch == '^':
+                self.pos += 1
+                if self.pos < self.n:
+                    inner_chars.append(self.text[self.pos])
+                    self.pos += 1
+                continue
+            inner_chars.append(ch)
+            self.pos += 1
+        if self.pos < self.n and self.text[self.pos] == end_char:
+            self.pos += 1
+        inner_text = ''.join(inner_chars)
+        parsed_inner = _InlineParser(inner_text).parse()
+        return f'{open_tag}{parsed_inner}{close_tag}'
+    def _parse_link(self):
+        self.pos += 1
+        text_start = self.pos
+        while self.pos < self.n and self.text[self.pos] != '*':
+            if self.text[self.pos] == '^':
+                self.pos += 1
+                if self.pos < self.n:
+                    self.pos += 1
+                continue
+            self.pos += 1
+        if self.pos >= self.n or self.text[self.pos] != '*':
+            return '*' + self.text[text_start:self.pos]
+        link_text = self.text[text_start:self.pos]
+        self.pos += 1
+        if self.pos < self.n and self.text[self.pos] == '(':
+            self.pos += 1
+            url_start = self.pos
+            while self.pos < self.n and self.text[self.pos] != ')':
+                self.pos += 1
+            if self.pos < self.n and self.text[self.pos] == ')':
+                url = self.text[url_start:self.pos]
+                self.pos += 1
+                parsed_text = _InlineParser(link_text).parse()
+                return f'<a href="{url}">{parsed_text}</a>'
+            else:
+                return '*' + link_text + '*(' + self.text[url_start:self.pos]
+        else:
+            return '*' + link_text + '*'
+# ============================================================
+# 3. 行内解析入口
+# ============================================================
+def parse_inline(text):
+    escaped_text = escape_text(text)
+    def replace_comment(m):
+        if re.search(r'https?://|ftp://|@', m.group(1)):
+            return m.group(0)
+        return f'<!-- {m.group(1)} -->'
+    escaped_text = re.sub(r'<([^>]+)>', replace_comment, escaped_text)
+    escaped_text = re.sub(r'\[(\d+)\]<([^>]+)>', r'<sup title="\2">[\1]</sup>', escaped_text)
+    escaped_text = re.sub(r'\$(.+?)\$\(([^\)]+)\)', r'<img src="\2" alt="\1">', escaped_text)
+    parser = _InlineParser(escaped_text)
+    result = parser.parse()
+    result = unescape_text(result)
+    return result
+# ============================================================
+# 4. 块级解析（支持多行表格）
+# ============================================================
+def zarkdown_to_html(text):
+    lines = text.split('\n')
+    result, i = [], 0
+    while i < len(lines):
+        raw_line = lines[i]
+        escaped_line = escape_text(raw_line)
+        # ---- 多行代码块 ----
+        if re.match(r'^~[a-zA-Z0-9_]+$', raw_line.strip()):
+            lang = raw_line.strip()[1:]
+            code_lines = []
+            i += 1
+            while i < len(lines) and lines[i].strip() != '~':
+                code_lines.append(lines[i])
+                i += 1
+            if i < len(lines) and lines[i].strip() == '~':
+                i += 1
+            result.append(f'<pre><code class="language-{lang}">{"\n".join(code_lines)}</code></pre>')
+            continue
+        # ---- 表格（支持多行单元格） ----
+        if re.match(r'^\|.*\|$', escaped_line) and i + 2 < len(lines):
+            next_esc = escape_text(lines[i+1])
+            after_esc = escape_text(lines[i+2]) if i+2 < len(lines) else ''
+            if re.match(r'^-{5,}$', next_esc.strip()) and re.match(r'^\|.*\|$', after_esc):
+                headers = [h.strip() for h in escaped_line.split('|')[1:-1]]
+                html = ['<table><thead><tr>']
+                for h in headers:
+                    html.append(f'<th>{parse_inline(h)}</th>')
+                html.append('</tr></thead><tbody>')
+                j = i + 2
+                current_cells = None
+                in_data_row = False
+                while j < len(lines):
+                    cur_raw = lines[j]
+                    cur_esc = escape_text(cur_raw)
+                    trimmed = cur_esc.strip()
+                    if re.match(r'^-{5,}$', trimmed):
+                        j += 1
+                        continue
+                    if re.match(r'^\|.*\|$', cur_esc):
+                        if in_data_row and current_cells is not None:
+                            html.append('<tr>')
+                            for cell in current_cells:
+                                html.append(f'<td>{parse_inline(cell)}</td>')
+                            html.append('</tr>')
+                            current_cells = None
+                            in_data_row = False
+                        cells = [c.strip() for c in cur_esc.split('|')[1:-1]]
+                        while len(cells) < len(headers):
+                            cells.append('')
+                        current_cells = cells
+                        in_data_row = True
+                        j += 1
+                        continue
+                    elif in_data_row and cur_raw.startswith('  '):
+                        if current_cells and len(current_cells) > 0:
+                            content = cur_raw.lstrip()
+                            current_cells[-1] = current_cells[-1] + '[Z_BR]' + content
+                        j += 1
+                        continue
+                    else:
+                        break
+                if in_data_row and current_cells is not None:
+                    html.append('<tr>')
+                    for cell in current_cells:
+                        html.append(f'<td>{parse_inline(cell)}</td>')
+                    html.append('</tr>')
+                html.append('</tbody></table>')
+                result.append(''.join(html))
+                i = j
+                continue
+        # ---- 标题 ----
+        if re.match(r'^//// ', escaped_line):
+            result.append(f'<h4>{parse_inline(escaped_line[5:])}</h4>')
+        elif re.match(r'^/// ', escaped_line):
+            result.append(f'<h3>{parse_inline(escaped_line[4:])}</h3>')
+        elif re.match(r'^// ', escaped_line):
+            result.append(f'<h2>{parse_inline(escaped_line[3:])}</h2>')
+        elif re.match(r'^/ ', escaped_line):
+            result.append(f'<h1>{parse_inline(escaped_line[2:])}</h1>')
+        # ---- 无序列表 ----
+        elif escaped_line.startswith('!'):
+            items = []
+            while i < len(lines) and escape_text(lines[i]).startswith('!'):
+                items.append(f'<li>{parse_inline(escape_text(lines[i])[1:].strip())}</li>')
+                i += 1
+            result.append(f'<ul>{"".join(items)}</ul>')
+            continue
+        # ---- 有序列表 ----
+        elif escaped_line.startswith('•'):
+            items = []
+            while i < len(lines) and escape_text(lines[i]).startswith('•'):
+                items.append(f'<li>{parse_inline(escape_text(lines[i])[1:].strip())}</li>')
+                i += 1
+            result.append(f'<ol>{"".join(items)}</ol>')
+            continue
+        # ---- 引用 ----
+        elif escaped_line.startswith('|'):
+            result.append(f'<blockquote>{parse_inline(escaped_line[1:].strip())}</blockquote>')
+        # ---- 分割线 ----
+        elif re.match(r'^-{5,}$', escaped_line.strip()):
+            result.append('<hr>')
+        # ---- 普通段落 ----
+        else:
+            if raw_line.strip():
+                result.append(f'<p>{parse_inline(escaped_line)}</p>')
+            else:
+                result.append('')
+        i += 1
+    # 拼接 HTML 内容
+    html_content = '\n'.join(result)
+    # 将占位符 [Z_BR] 替换为真正的 <br>
+    html_content = html_content.replace('[Z_BR]', '<br>')
+    # 返回完整 HTML 页面
+    return f'''<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Zarkdown 输出</title>
+    <style>
+        body {{
+            max-width: 800px;
+            margin: 40px auto;
+            padding: 0 20px;
+            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+            line-height: 1.6;
+            color: #1e1e2f;
+            background-color: #fafafa;
+        }}
+        h1, h2, h3, h4 {{ color: #1e1e2f; margin-top: 1.5em; }}
+        h1 {{ border-bottom: 2px solid #eee; padding-bottom: 0.3em; }}
+        blockquote {{
+            margin: 1.2em 0;
+            padding: 0.8em 1.2em;
+            border-left: 4px solid #4a90d9;
+            background-color: #f0f4ff;
+            border-radius: 0 4px 4px 0;
+            color: #2c3e50;
+        }}
+        table {{
+            border-collapse: collapse;
+            width: 100%;
+            margin: 1em 0;
+            font-size: 0.95em;
+        }}
+        th, td {{
+            border: 1px solid #ddd;
+            padding: 8px 12px;
+            text-align: left;
+            vertical-align: top;
+        }}
+        th {{
+            background-color: #f2f2f2;
+            font-weight: 600;
+        }}
+        tr:nth-child(even) {{ background-color: #f9f9f9; }}
+        pre {{
+            background: #f6f8fa;
+            padding: 16px;
+            border-radius: 6px;
+            overflow-x: auto;
+        }}
+        code {{
+            font-family: "SF Mono", "Fira Code", monospace;
+            font-size: 0.9em;
+        }}
+        hr {{
+            border: none;
+            border-top: 2px dashed #ccc;
+            margin: 2em 0;
+        }}
+        sup {{
+            background: #eee;
+            padding: 0.1em 0.4em;
+            border-radius: 4px;
+            font-size: 0.75em;
+            cursor: help;
+        }}
+        img {{
+            max-width: 100%;
+            height: auto;
+        }}
+    </style>
+</head>
+<body>
+{html_content}
+</body>
+</html>'''
+# ============================================================
+# 5. 命令行入口（集成错误检查器，支持 --no-check）
+# ============================================================
+def main():
+    parser = argparse.ArgumentParser(description="将 Zarkdown 文件转为 HTML/PDF/DOCX/LaTeX")
+    parser.add_argument("input", help="输入的 .zkdn 文件路径")
+    parser.add_argument("-o", "--output", help="输出的文件路径（默认：根据输入文件名和格式自动生成）", default=None)
+    parser.add_argument("-w", "--watch", action="store_true", help="监听文件变化，自动重新转换并刷新浏览器（仅 HTML 格式）")
+    parser.add_argument("-f", "--format",
+                        choices=['html', 'pdf', 'docx', 'latex'],
+                        default='html',
+                        help="输出格式: html, pdf, docx, latex (默认: html)")
+    parser.add_argument("--no-check", action="store_true", help="跳过语法错误检查（不推荐）")
+    args = parser.parse_args()
+    # 自动生成输出文件名
+    if args.output is None:
+        base = args.input.rsplit('.', 1)[0]
+        if args.format == 'html':
+            args.output = base + '.html'
+        elif args.format == 'pdf':
+            args.output = base + '.pdf'
+        elif args.format == 'docx':
+            args.output = base + '.docx'
+        elif args.format == 'latex':
+            args.output = base + '.tex'
+        else:
+            args.output = base + '.html'
+    def convert():
+        try:
+            with open(args.input, 'r', encoding='utf-8-sig') as f:
+                content = f.read()
+            # ---- 执行错误检查（除非用户指定 --no-check） ----
+            if not args.no_check:
+                errors = validate_zarkdown(content)
+                if errors:
+                    print_errors(errors)
+                    return  # 停止转换
+            # ---- 正常转换 ----
+            html = zarkdown_to_html(content)
+            if args.format == 'html':
+                with open(args.output, 'w', encoding='utf-8') as f:
+                    f.write(html)
+                print(f"✅ {args.input} -> {args.output}  ({time.strftime('%H:%M:%S')})")
+                if args.watch:
+                    webbrowser.open('file://' + os.path.abspath(args.output))
+            else:
+                if pypandoc is None:
+                    print("❌ 导出 PDF/DOCX/LaTeX 需要安装 pypandoc 和 pandoc 工具。")
+                    print("   pip install pypandoc")
+                    print("   https://pandoc.org/installing.html")
+                    return
+                extra_args = []
+                if args.format == 'pdf':
+                    extra_args = ['--pdf-engine=xelatex']
+                try:
+                    pypandoc.convert_text(
+                        html,
+                        to=args.format,
+                        format='html',
+                        outputfile=args.output,
+                        extra_args=extra_args
+                    )
+                    print(f"✅ {args.input} -> {args.output} ({args.format})  ({time.strftime('%H:%M:%S')})")
+                except Exception as e:
+                    print(f"❌ 导出 {args.format} 失败: {e}")
+                    print("   请确认 pandoc 已正确安装，且 PDF 导出需要 LaTeX 引擎 (如 xelatex)")
+        except FileNotFoundError:
+            print(f"❌ 错误：找不到文件 {args.input}")
+        except Exception as e:
+            print(f"❌ 转换出错: {e}")
+    # 首次转换
+    convert()
+    if args.watch and args.format == 'html':
+        print(f"👀 正在监听 {args.input} 的变化（按 Ctrl+C 停止）...")
+        try:
+            last_mtime = os.path.getmtime(args.input)
+            while True:
+                current_mtime = os.path.getmtime(args.input)
+                if current_mtime > last_mtime:
+                    last_mtime = current_mtime
+                    convert()
+                time.sleep(0.5)
+        except KeyboardInterrupt:
+            print("\n👋 停止监听")
+    elif args.watch and args.format != 'html':
+        print("⚠️ 监听模式仅支持 HTML 格式。请使用 -f html 或移除 -w 参数。")
+if __name__ == "__main__":
+    main()

zarkdown-2.0.1/src/zarkdown.egg-info/PKG-INFO ADDED Viewed

@@ -0,0 +1,187 @@
+Metadata-Version: 2.4
+Name: zarkdown
+Version: 2.0.1
+Summary: Zarkdown - 键盘友好型纯文本标记语言
+Author-email: yangzizhoudiwuxuande <yangzizhou2026@outlook.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yangzizhoudiwuxuande/zarkdown
+Project-URL: Bug Tracker, https://github.com/yangzizhoudiwuxuande/zarkdown/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+# ✨ Zarkdown （版本2.0.1）
+> **键盘友好型纯文本标记语言** —— 所有符号均位于键盘主键区，无需按 Shift 组合键。
+[![Python Version](https://img.shields.io/badge/python-3.6+-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/yangzizhoudiwuxuande/zarkdown)](https://github.com/yangzizhoudiwuxuande/zarkdown/stargazers)
+Zarkdown 是一种全新的纯文本标记语言，专为**快速写作**和**极致键盘效率**而设计。它适合用来写笔记、技术文档、博客文章，甚至可以作为配置文件的格式。
+---
+## 🎯 设计哲学
+- **键盘友好**：所有语法符号都在主键区，手指不需要大范围移动
+- **直观易记**：`/` 表示标题（像路径层级），`?` 表示加粗（像强调语气）
+- **纯文本**：任何文本编辑器都能打开，人类可读性强
+- **可扩展**：支持表格、代码块、脚注等高级功能
+---
+## 📜 完整语法表
+| 效果 | 语法 | 示例 | 渲染为 |
+| :--- | :--- | :--- | :--- |
+| **标题 1~4 级** | `/` `//` `///` `////` + 空格 | `/ 大标题` | `<h1>`~`<h4>` |
+| **粗体** | `?文字?` | `?重要?` | `<strong>` |
+| **斜体** | `\文字\` | `\斜体\` | `<i>` |
+| **删除线** | `-文字-` | `-删掉-` | `<del>` |
+| **超链接** | `*文字*(链接)` | `*点击*(https://x.com)` | `<a>` |
+| **图片** | `$图片名$(链接)` | `$logo$(./pic.png)` | `<img>` |
+| **行内代码** | `~文字~` | `~npm i~` | `<code>` |
+| **多行代码块** | `~语言` 开头 + `~` 结尾 | `~python`...`~` | `<pre><code>` |
+| **无序列表** | `!文字`（行首） | `!苹果` | `<ul><li>` |
+| **有序列表** | `•文字`（行首，U+2022） | `•第一` | `<ol><li>` |
+| **引用** | `\|文字`（行首） | `\| 引文` | `<blockquote>` |
+| **表格** | `\| 表头 \|` + `------` | 见下方示例 | `<table>` |
+| **注释** | `<文字>`（不含URL） | `<备注>` | `<!-- -->` |
+| **脚注** | `[数字]<文字>` | `[1]<说明>` | `<sup title="">` |
+| **分割线** | `-----`（独占一行） | | `<hr>` |
+| **转义** | `^` 加在任意符号前 | `^/ 不是标题` | 原样输出 |
+---
+## 🚀 快速上手
+### 安装
+```bash
+# 克隆仓库
+git clone https://github.com/yangzizhoudiwuxuande/zarkdown.git
+cd zarkdown
+# 创建虚拟环境（推荐）
+python3 -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+# 安装
+pip install -e .
+```
+---
+## 使用
+```bash
+# 转换 .zkdn 文件为 .html
+zarkdown example.zkdn -o example.html
+# 直接输出到终端（不生成文件）
+zarkdown example.zkdn
+```
+---
+## 示例
+### 转为HTML
+创建一个`hello.zkdn`文件：
+```zkdn
+/ Zarkdown 欢迎页
+?恭喜?，您的格式已经跑通了！
+这里有一个链接：*点击访问*(https://github.com/yangzizhoudiwuxuande)
+~python
+print("Hello Zarkdown!")
+~
+```
+然后运行：
+```bash
+zarkdown hello.zkdn -w
+```
+浏览器会自动打开，显示渲染后的 HTML 页面。修改 `hello.zkdn` 并保存，页面会自动刷新。
+### 转为Word/LaTex
+转为Word/LaTex需要安装Pandoc。
+```bash
+brew install pandoc
+```
+转为Word
+```bash
+zarkdown my_note.zkdn -f docx
+```
+转为LaTex
+```bash
+zarkdown my_note.zkdn -f latex
+```
+## 📸 效果预览
+[![pm4y4lF.png](https://s41.ax1x.com/2026/08/01/pm4y4lF.png)](https://imgchr.com/i/pm4y4lF)
+## 贡献
+欢迎任何形式的贡献！你可以：
+* 🐛 报告 Bug（在 Issues 中描述）
+* 💡 提出新功能建议
+* 📝 完善文档
+* 🔧 提交 Pull Request
+## 📄 许可证
+本项目采用 MIT License 开源协议，你可以自由使用、修改、分发。
+## ❤️ 致谢
+感谢你阅读这份文档！如果觉得 Zarkdown 有趣，欢迎给项目点一颗 ⭐ 星，让更多人看到它。
+## 📝 更新日志
+**v2.0.1 (2026-08-01)**
+- **语法错误检查器**
+  转换前自动扫描全文，检测未闭合的成对符号（`?`、`\`、`-`、`~`、`*`、`$`、`[`、`<`），并精确报告行号和列号，帮助用户快速定位问题。
+- **括号配对检查**
+  针对超链接 `*文字*(链接)` 和图片 `$图片名$(链接)`，自动检测缺失的闭合括号 `)`，避免生成无效链接。
+- **多行表格支持**
+  表格单元格内允许换行，通过缩进续行自动合并内容，并在输出中转换为 `<br>` 换行符。
+- **转义字符 `^`**
+  在任意特殊符号前添加 `^` 即可原样输出，避免被解析器处理，例如 `^/ 不是标题`。
+- **智能跳过机制**
+  错误检查器自动跳过分割线（以 `-----` 开头的行）、表格分隔行以及多行代码块内部内容，避免误报。
+- **自动生成输出文件名**
+  若不指定 `-o`，输出文件名将根据输入文件名和格式自动生成（如 `note.html`、`note.pdf` 等）。
+**v2.0.0 (2026-07-28)**
+* 支持导出为Word/LaTex等格式（需安装Pandoc）
+**v1.2.2 (2026-07-26)**
+* 支持多行表格
+**v1.2.1 (2026-07-26)**
+* 支持嵌套语法（粗体里套斜体、超链接里套粗体等）
+**v1.2.0 (2026-07-25)**
+* 使引用和表格变得更好看
+**v1.1.0 (2026-07-25)**
+* ✨ 新增 `-w` 监听模式，保存即自动重新转换
+* ✨ 自动在浏览器中打开生成 HTML，实现实时预览
+* 🐛 修复中文编码问题，兼容带 BOM 的 UTF-8 文件
+* 🐛 修复 macOS 下相对路径打开失败的问题
+* 📝 完善 README 文档，增加完整语法表和示例
+**v1.0.0 (2026-07-25)**
+* 🎉 首次发布，支持完整的 Zarkdown 语法
+---
+Happy Writing with Zarkdown!
+## 联系
+yangzizhou2026@outlook.com

zarkdown-2.0.1/src/zarkdown.egg-info/SOURCES.txt ADDED Viewed

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+src/zarkdown/__init__.py
+src/zarkdown/core.py
+src/zarkdown.egg-info/PKG-INFO
+src/zarkdown.egg-info/SOURCES.txt
+src/zarkdown.egg-info/dependency_links.txt
+src/zarkdown.egg-info/entry_points.txt
+src/zarkdown.egg-info/top_level.txt

zarkdown-2.0.1/src/zarkdown.egg-info/dependency_links.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+

zarkdown-2.0.1/src/zarkdown.egg-info/entry_points.txt ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ [console_scripts]
2	+ zarkdown = zarkdown.core:main

zarkdown-2.0.1/src/zarkdown.egg-info/top_level.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+ zarkdown