尧图网站建设 
简介Typora-Academic-Zh 是一套面向中文写作者、科研人员与学生的 Typora 学术风格主题基于官方 Academic 主题改造正文字体采用华文中宋等宽字体选用 CamingoCode主要解决中文排版下字体不协调、代码块样式单调的问题。与 Academic 的差异集中在代码块设计上作者偏好带外边框的代码样式示例效果可参看包内 README.pdf。资源包共 14 个文件以 woff 字体文件为主另含 css 样式表、pdf 说明与 md 文档压缩包约 15.46MB字体与样式分离便于按需替换。安装时只需将 academic-zh 目录与 academic-zh.css 解压至 Typora 主题文件夹即可启用。主题还支持通过 div 右对齐、center 居中等排版技巧适合需要撰写论文、报告或技术文档的用户快速获得统一的中文学术视觉风格。目前已有 451 人学习下载。1. 中文学术写作的排版困局为什么 Typora 默认主题写论文总差口气用 Typora 写论文、开题报告、文献综述的人多半经历过这个瞬间Markdown 源码里逻辑清清楚楚导出 PDF 一看中文段落像被揉皱的稿纸——行距忽宽忽窄标点挤在行尾标题层级和正文字号拉不开差距参考文献列表更是毫无学术感。Typora-Academic-Zh 这个主题瞄准的就是这个落差它是一套面向中文学术写作场景的 Typora CSS 主题把默认的西文排版逻辑替换成适配中文的字体栈、行高、段间距和标题层级让 Markdown 预览和导出结果更接近期刊投稿或学位论文的观感。它适合三类人用 Typora 写论文的研究生、需要频繁输出中文技术文档的工程师、以及把 Typora 当主力编辑器但受不了默认主题「太像笔记软件」的写作者。核心诉求不是花哨而是让中文正文读起来不累、标题层级一眼可辨、导出后不用再手工调格式。下面从主题结构、安装配置、参数调优到避坑按可复现的路径拆开讲。2. 拆开一套 Typora 中文主题文件结构、CSS 变量与生效链路2.1 主题包到底由哪些文件组成Typora 主题不是单个 CSS 文件而是一组按约定命名的资源。常见做法是一个主 CSS 文件负责全局排版一个*.user.css或变量文件负责可覆盖的参数外加字体文件和预览截图。以 Typora-Academic-Zh 这类中文学术主题为例典型结构如下文件/目录作用是否必须academic-zh.css主样式定义正文、标题、代码块、表格是academic-zh.user.css用户覆盖层放个人参数改动建议fonts/中文字体文件如思源宋体、霞鹜文楷视需求academic-zh/主题文件夹放入 Typora 主题目录是主 CSS 里最关键的是:root下的 CSS 变量。学术排版的可调项集中在字体族、字号阶梯、行高、段间距、标题上下边距、引用块样式这几组。把变量抽出来改主题就不用翻几百行 CSS。:root { --font-body: Source Han Serif SC, Noto Serif CJK SC, serif; --font-heading: Source Han Sans SC, Noto Sans CJK SC, sans-serif; --font-mono: JetBrains Mono, Cascadia Code, monospace; --font-size-body: 16px; --line-height-body: 1.8; --para-spacing: 0.9em; --h1-size: 1.8em; --h2-size: 1.45em; --h3-size: 1.2em; }这段变量定义决定了整篇文档的骨架。--font-body用衬线字体是学术场景的常见选择正文读起来更像印刷品--font-heading用无衬线拉开标题与正文的视觉差异--line-height-body: 1.8是中文长文比较舒服的行高低于 1.6 会显得挤高于 2.0 又太散。--para-spacing控制段落间距中文段落通常不需要首行缩进靠段间距分隔更清爽。2.2 主题生效的完整链路Typora 加载主题的顺序是内置基础样式 → 主题目录下的主 CSS → 用户覆盖 CSS。理解这个顺序才能知道改哪里不会被冲掉。操作步骤打开 Typora进入「偏好设置 → 外观 → 打开主题文件夹」。把主题文件夹整体复制进去确保 CSS 文件名和文件夹名一致。重启 Typora在「主题」菜单里选中该主题。若需微调只改.user.css不动主 CSS。# macOS 主题目录常见位置 ~/Library/Application Support/abnerworks.Typora/themes/ # Windows 主题目录常见位置 %APPDATA%\Typora\themes\ # 复制主题文件夹示例 cp -r Typora-Academic-Zh ~/Library/Application\ Support/abnerworks.Typora/themes/命令含义很直接把主题目录放到 Typora 约定的 themes 路径下。参数说明路径中的abnerworks.Typora是 macOS 版 Typora 的 bundle 标识Windows 用%APPDATA%环境变量。复制后必须重启Typora 不会热加载新主题文件夹。如果主题菜单里看不到先检查文件夹层级——常见错误是套了两层同名目录导致 CSS 不在 themes 根下。提示改主题前先备份原文件。CSS 覆盖是层叠的改错一行可能让整篇文档排版崩掉有备份才有后悔药。3. 从零装好 Typora-Academic-Zh字体、CSS 与导出参数3.1 字体准备中文衬线字体是学术感的底座学术排版对字体的要求比普通笔记高。正文用衬线、标题用无衬线、代码用等宽是期刊和学位论文的常见惯例。Typora-Academic-Zh 的字体栈里中文正文优先思源宋体或霞鹜文楷标题优先思源黑体。安装字体的步骤下载思源宋体 / 思源黑体开源可商用。系统安装后确认字体名称与 CSS 里写的一致。若不想装系统字体可把字体文件放进主题的fonts/目录用font-face引入。font-face { font-family: Academic Serif SC; src: url(./fonts/SourceHanSerifSC-Regular.otf) format(opentype); font-weight: 400; font-display: swap; } font-face { font-family: Academic Serif SC; src: url(./fonts/SourceHanSerifSC-Bold.otf) format(opentype); font-weight: 700; font-display: swap; }逻辑说明font-face把字体文件注册成自定义字体族CSS 里就能用Academic Serif SC引用。font-display: swap让字体加载期间先用回退字体渲染避免白屏。参数上font-weight要和文件实际字重对应Regular 对 400、Bold 对 700写错会导致浏览器合成假粗体中文会糊。3.2 正文与标题的 CSS 调参装好字体后核心调参集中在正文和标题。下面是一组可直接抄的规则#write { font-family: var(--font-body); font-size: var(--font-size-body); line-height: var(--line-height-body); max-width: 42em; margin: 0 auto; padding: 2.5em 1.5em; text-align: justify; text-justify: inter-ideograph; } #write p { margin: 0 0 var(--para-spacing) 0; text-indent: 0; } #write h1, #write h2, #write h3 { font-family: var(--font-heading); font-weight: 700; line-height: 1.35; margin-top: 1.6em; margin-bottom: 0.6em; } #write h1 { font-size: var(--h1-size); } #write h2 { font-size: var(--h2-size); } #write h3 { font-size: var(--h3-size); }逐项说明max-width: 42em限制正文宽度中文一行 35 到 45 字比较易读太宽会让人串行。text-align: justify配合text-justify: inter-ideograph是中文两端对齐的关键后者让标点挤压更合理避免行尾出现大块空白。text-indent: 0明确取消首行缩进学术中文常用段间距而非缩进分隔段落。标题的margin-top大于margin-bottom形成「标题靠近下文」的视觉分组这是排版里的亲密性原则。3.3 导出 PDF 的参数对齐预览好看不等于导出好看。Typora 导出 PDF 时页边距、字体嵌入、分页规则都会影响最终结果。导出项建议值原因页边距上下 2.5cm左右 2.5cm接近学位论文要求字体嵌入开启避免换机器后字体丢失标题分页H1 前分页章节独立起页代码块换行关闭保持代码原样media print { #write { max-width: none; padding: 0; font-size: 12pt; } #write h1 { page-break-before: always; } #write pre { white-space: pre-wrap; word-break: break-all; } }media print里的规则只在打印/导出 PDF 时生效。page-break-before: always让每个一级标题另起一页符合论文章节习惯。white-space: pre-wrap让过长的代码行自动换行避免溢出页面。注意font-size用pt而不是px打印场景下pt更稳定。注意导出前先在 Typora 里用「文件 → 导出 → PDF」预览一次确认分页和字体没问题。直接打印不预览翻车概率很高。4. 避坑与排查主题装了不生效、字体糊、导出跑版怎么办4.1 主题菜单里找不到新主题现象把主题文件夹复制进 themes 目录重启后主题列表里没有。原因文件夹层级套错或者 CSS 文件名与文件夹名不一致。Typora 要求主题文件夹下直接是 CSS 文件不能多套一层。解决检查路径是否为themes/主题名/主题名.css。如果变成themes/主题名/主题名/主题名.css把内层文件上移一层。CSS 文件名建议与文件夹名保持一致减少识别问题。4.2 中文显示为方块或糊成一片现象正文中文变成方框或者粗细不均、边缘发虚。原因CSS 里指定的字体系统没装回退到了不含中文的字体或者font-weight与字体文件字重不匹配触发了合成粗体。解决先用系统字体册确认字体名称拼写完全一致。若用font-face检查src路径相对 CSS 文件是否正确。合成粗体问题把font-weight改成字体实际支持的字重或引入对应的 Bold 文件。4.3 两端对齐后行尾出现大空洞现象开启text-align: justify后某些行字距被拉得很开行尾像被撕开。原因中文长句里混了英文单词或长 URL浏览器为了对齐强行拉伸空格。解决给#write加word-break: break-word和overflow-wrap: anywhere让超长英文串可断行。同时确认text-justify: inter-ideograph已生效它比默认的auto更适合中文标点。4.4 导出 PDF 后标题分页失效现象预览里 H1 前有分页导出后章节还是连在一起。原因分页规则写在了普通 CSS 里没放进media print或者导出时用了「无样式」选项。解决把page-break-before规则移进media print块。导出对话框里确认样式选项为「默认」而非「无」。另外部分 Typora 版本对page-break-before支持不稳定可改用break-before: page。4.5 代码块在 PDF 里溢出页面现象长代码行被截断右侧内容丢失。原因pre默认white-space: pre不换行。解决在media print里给pre设white-space: pre-wrap和word-break: break-all。如果代码本身有横向滚动需求导出前手动折行或调小代码字号。5. 进阶用 CSS 变量做一套可切换的学术排版方案主题用久了会发现不同场景对排版的要求不一样开题报告要宽松期刊投稿要紧凑课程作业要接近 Word 默认。与其改来改去不如把变量抽成几套预设用注释切换。/* 预设 A学位论文宽松行高衬线正文 */ :root { --font-body: Source Han Serif SC, serif; --line-height-body: 1.9; --para-spacing: 1em; --font-size-body: 16px; } /* 预设 B期刊投稿紧凑字号偏小 */ /* :root { --font-body: Source Han Serif SC, serif; --line-height-body: 1.6; --para-spacing: 0.6em; --font-size-body: 14px; } */ /* 预设 C技术文档无衬线正文代码友好 */ /* :root { --font-body: Source Han Sans SC, sans-serif; --line-height-body: 1.7; --para-spacing: 0.8em; --font-size-body: 15px; } */用法很简单默认启用预设 A需要切换时把 A 注释掉、取消 B 或 C 的注释重启 Typora 即可。这样一套主题覆盖三种场景不用维护多份 CSS。验证方法切换后打开一篇含标题、正文、代码块、表格、引用的完整文档逐项检查行高、段距、标题层级、代码换行。重点看导出 PDF 后分页和字体嵌入是否正常。我一般会准备一篇「排版测试稿」每次改完变量都导出一遍对比前后差异。一个具体技巧把--para-spacing和--line-height-body联动调。行高加大时段间距可以适当减小否则整篇会显得松散行高收紧时段间距要略增否则段落会粘在一起。这两个参数是一对单独调一个往往达不到预期。踩过的坑里最费时间的是字体名称拼写。CSS 里写Source Han Serif SC系统里装的却是Source Han Serif CN差一个字母就回退到默认字体预览里看不出明显异常导出后才发现中文变成了宋体以外的字体。后来我养成习惯装完字体先在系统字体册里复制准确名称再粘贴进 CSS不手打。另一条血泪经验是改主题前一定备份.user.css。有次直接改主 CSSTypora 升级后主题被覆盖所有调参白做。现在所有个人改动只写在.user.css里主 CSS 保持原样升级也不怕。希望帮到你。本文还有配套的精品资源点击获取 Typora中文学术排版实战：CSS主题配置与PDF导出优化
简介Typora-Academic-Zh 是一套面向中文写作者、科研人员与学生的 Typora 学术风格主题基于官方 Academic 主题改造正文字体采用华文中宋等宽字体选用 CamingoCode主要解决中文排版下字体不协调、代码块样式单调的问题。与 Academic 的差异集中在代码块设计上作者偏好带外边框的代码样式示例效果可参看包内 README.pdf。资源包共 14 个文件以 woff 字体文件为主另含 css 样式表、pdf 说明与 md 文档压缩包约 15.46MB字体与样式分离便于按需替换。安装时只需将 academic-zh 目录与 academic-zh.css 解压至 Typora 主题文件夹即可启用。主题还支持通过 div 右对齐、center 居中等排版技巧适合需要撰写论文、报告或技术文档的用户快速获得统一的中文学术视觉风格。目前已有 451 人学习下载。1. 中文学术写作的排版困局为什么 Typora 默认主题写论文总差口气用 Typora 写论文、开题报告、文献综述的人多半经历过这个瞬间Markdown 源码里逻辑清清楚楚导出 PDF 一看中文段落像被揉皱的稿纸——行距忽宽忽窄标点挤在行尾标题层级和正文字号拉不开差距参考文献列表更是毫无学术感。Typora-Academic-Zh 这个主题瞄准的就是这个落差它是一套面向中文学术写作场景的 Typora CSS 主题把默认的西文排版逻辑替换成适配中文的字体栈、行高、段间距和标题层级让 Markdown 预览和导出结果更接近期刊投稿或学位论文的观感。它适合三类人用 Typora 写论文的研究生、需要频繁输出中文技术文档的工程师、以及把 Typora 当主力编辑器但受不了默认主题「太像笔记软件」的写作者。核心诉求不是花哨而是让中文正文读起来不累、标题层级一眼可辨、导出后不用再手工调格式。下面从主题结构、安装配置、参数调优到避坑按可复现的路径拆开讲。2. 拆开一套 Typora 中文主题文件结构、CSS 变量与生效链路2.1 主题包到底由哪些文件组成Typora 主题不是单个 CSS 文件而是一组按约定命名的资源。常见做法是一个主 CSS 文件负责全局排版一个*.user.css或变量文件负责可覆盖的参数外加字体文件和预览截图。以 Typora-Academic-Zh 这类中文学术主题为例典型结构如下文件/目录作用是否必须academic-zh.css主样式定义正文、标题、代码块、表格是academic-zh.user.css用户覆盖层放个人参数改动建议fonts/中文字体文件如思源宋体、霞鹜文楷视需求academic-zh/主题文件夹放入 Typora 主题目录是主 CSS 里最关键的是:root下的 CSS 变量。学术排版的可调项集中在字体族、字号阶梯、行高、段间距、标题上下边距、引用块样式这几组。把变量抽出来改主题就不用翻几百行 CSS。:root { --font-body: Source Han Serif SC, Noto Serif CJK SC, serif; --font-heading: Source Han Sans SC, Noto Sans CJK SC, sans-serif; --font-mono: JetBrains Mono, Cascadia Code, monospace; --font-size-body: 16px; --line-height-body: 1.8; --para-spacing: 0.9em; --h1-size: 1.8em; --h2-size: 1.45em; --h3-size: 1.2em; }这段变量定义决定了整篇文档的骨架。--font-body用衬线字体是学术场景的常见选择正文读起来更像印刷品--font-heading用无衬线拉开标题与正文的视觉差异--line-height-body: 1.8是中文长文比较舒服的行高低于 1.6 会显得挤高于 2.0 又太散。--para-spacing控制段落间距中文段落通常不需要首行缩进靠段间距分隔更清爽。2.2 主题生效的完整链路Typora 加载主题的顺序是内置基础样式 → 主题目录下的主 CSS → 用户覆盖 CSS。理解这个顺序才能知道改哪里不会被冲掉。操作步骤打开 Typora进入「偏好设置 → 外观 → 打开主题文件夹」。把主题文件夹整体复制进去确保 CSS 文件名和文件夹名一致。重启 Typora在「主题」菜单里选中该主题。若需微调只改.user.css不动主 CSS。# macOS 主题目录常见位置 ~/Library/Application Support/abnerworks.Typora/themes/ # Windows 主题目录常见位置 %APPDATA%\Typora\themes\ # 复制主题文件夹示例 cp -r Typora-Academic-Zh ~/Library/Application\ Support/abnerworks.Typora/themes/命令含义很直接把主题目录放到 Typora 约定的 themes 路径下。参数说明路径中的abnerworks.Typora是 macOS 版 Typora 的 bundle 标识Windows 用%APPDATA%环境变量。复制后必须重启Typora 不会热加载新主题文件夹。如果主题菜单里看不到先检查文件夹层级——常见错误是套了两层同名目录导致 CSS 不在 themes 根下。提示改主题前先备份原文件。CSS 覆盖是层叠的改错一行可能让整篇文档排版崩掉有备份才有后悔药。3. 从零装好 Typora-Academic-Zh字体、CSS 与导出参数3.1 字体准备中文衬线字体是学术感的底座学术排版对字体的要求比普通笔记高。正文用衬线、标题用无衬线、代码用等宽是期刊和学位论文的常见惯例。Typora-Academic-Zh 的字体栈里中文正文优先思源宋体或霞鹜文楷标题优先思源黑体。安装字体的步骤下载思源宋体 / 思源黑体开源可商用。系统安装后确认字体名称与 CSS 里写的一致。若不想装系统字体可把字体文件放进主题的fonts/目录用font-face引入。font-face { font-family: Academic Serif SC; src: url(./fonts/SourceHanSerifSC-Regular.otf) format(opentype); font-weight: 400; font-display: swap; } font-face { font-family: Academic Serif SC; src: url(./fonts/SourceHanSerifSC-Bold.otf) format(opentype); font-weight: 700; font-display: swap; }逻辑说明font-face把字体文件注册成自定义字体族CSS 里就能用Academic Serif SC引用。font-display: swap让字体加载期间先用回退字体渲染避免白屏。参数上font-weight要和文件实际字重对应Regular 对 400、Bold 对 700写错会导致浏览器合成假粗体中文会糊。3.2 正文与标题的 CSS 调参装好字体后核心调参集中在正文和标题。下面是一组可直接抄的规则#write { font-family: var(--font-body); font-size: var(--font-size-body); line-height: var(--line-height-body); max-width: 42em; margin: 0 auto; padding: 2.5em 1.5em; text-align: justify; text-justify: inter-ideograph; } #write p { margin: 0 0 var(--para-spacing) 0; text-indent: 0; } #write h1, #write h2, #write h3 { font-family: var(--font-heading); font-weight: 700; line-height: 1.35; margin-top: 1.6em; margin-bottom: 0.6em; } #write h1 { font-size: var(--h1-size); } #write h2 { font-size: var(--h2-size); } #write h3 { font-size: var(--h3-size); }逐项说明max-width: 42em限制正文宽度中文一行 35 到 45 字比较易读太宽会让人串行。text-align: justify配合text-justify: inter-ideograph是中文两端对齐的关键后者让标点挤压更合理避免行尾出现大块空白。text-indent: 0明确取消首行缩进学术中文常用段间距而非缩进分隔段落。标题的margin-top大于margin-bottom形成「标题靠近下文」的视觉分组这是排版里的亲密性原则。3.3 导出 PDF 的参数对齐预览好看不等于导出好看。Typora 导出 PDF 时页边距、字体嵌入、分页规则都会影响最终结果。导出项建议值原因页边距上下 2.5cm左右 2.5cm接近学位论文要求字体嵌入开启避免换机器后字体丢失标题分页H1 前分页章节独立起页代码块换行关闭保持代码原样media print { #write { max-width: none; padding: 0; font-size: 12pt; } #write h1 { page-break-before: always; } #write pre { white-space: pre-wrap; word-break: break-all; } }media print里的规则只在打印/导出 PDF 时生效。page-break-before: always让每个一级标题另起一页符合论文章节习惯。white-space: pre-wrap让过长的代码行自动换行避免溢出页面。注意font-size用pt而不是px打印场景下pt更稳定。注意导出前先在 Typora 里用「文件 → 导出 → PDF」预览一次确认分页和字体没问题。直接打印不预览翻车概率很高。4. 避坑与排查主题装了不生效、字体糊、导出跑版怎么办4.1 主题菜单里找不到新主题现象把主题文件夹复制进 themes 目录重启后主题列表里没有。原因文件夹层级套错或者 CSS 文件名与文件夹名不一致。Typora 要求主题文件夹下直接是 CSS 文件不能多套一层。解决检查路径是否为themes/主题名/主题名.css。如果变成themes/主题名/主题名/主题名.css把内层文件上移一层。CSS 文件名建议与文件夹名保持一致减少识别问题。4.2 中文显示为方块或糊成一片现象正文中文变成方框或者粗细不均、边缘发虚。原因CSS 里指定的字体系统没装回退到了不含中文的字体或者font-weight与字体文件字重不匹配触发了合成粗体。解决先用系统字体册确认字体名称拼写完全一致。若用font-face检查src路径相对 CSS 文件是否正确。合成粗体问题把font-weight改成字体实际支持的字重或引入对应的 Bold 文件。4.3 两端对齐后行尾出现大空洞现象开启text-align: justify后某些行字距被拉得很开行尾像被撕开。原因中文长句里混了英文单词或长 URL浏览器为了对齐强行拉伸空格。解决给#write加word-break: break-word和overflow-wrap: anywhere让超长英文串可断行。同时确认text-justify: inter-ideograph已生效它比默认的auto更适合中文标点。4.4 导出 PDF 后标题分页失效现象预览里 H1 前有分页导出后章节还是连在一起。原因分页规则写在了普通 CSS 里没放进media print或者导出时用了「无样式」选项。解决把page-break-before规则移进media print块。导出对话框里确认样式选项为「默认」而非「无」。另外部分 Typora 版本对page-break-before支持不稳定可改用break-before: page。4.5 代码块在 PDF 里溢出页面现象长代码行被截断右侧内容丢失。原因pre默认white-space: pre不换行。解决在media print里给pre设white-space: pre-wrap和word-break: break-all。如果代码本身有横向滚动需求导出前手动折行或调小代码字号。5. 进阶用 CSS 变量做一套可切换的学术排版方案主题用久了会发现不同场景对排版的要求不一样开题报告要宽松期刊投稿要紧凑课程作业要接近 Word 默认。与其改来改去不如把变量抽成几套预设用注释切换。/* 预设 A学位论文宽松行高衬线正文 */ :root { --font-body: Source Han Serif SC, serif; --line-height-body: 1.9; --para-spacing: 1em; --font-size-body: 16px; } /* 预设 B期刊投稿紧凑字号偏小 */ /* :root { --font-body: Source Han Serif SC, serif; --line-height-body: 1.6; --para-spacing: 0.6em; --font-size-body: 14px; } */ /* 预设 C技术文档无衬线正文代码友好 */ /* :root { --font-body: Source Han Sans SC, sans-serif; --line-height-body: 1.7; --para-spacing: 0.8em; --font-size-body: 15px; } */用法很简单默认启用预设 A需要切换时把 A 注释掉、取消 B 或 C 的注释重启 Typora 即可。这样一套主题覆盖三种场景不用维护多份 CSS。验证方法切换后打开一篇含标题、正文、代码块、表格、引用的完整文档逐项检查行高、段距、标题层级、代码换行。重点看导出 PDF 后分页和字体嵌入是否正常。我一般会准备一篇「排版测试稿」每次改完变量都导出一遍对比前后差异。一个具体技巧把--para-spacing和--line-height-body联动调。行高加大时段间距可以适当减小否则整篇会显得松散行高收紧时段间距要略增否则段落会粘在一起。这两个参数是一对单独调一个往往达不到预期。踩过的坑里最费时间的是字体名称拼写。CSS 里写Source Han Serif SC系统里装的却是Source Han Serif CN差一个字母就回退到默认字体预览里看不出明显异常导出后才发现中文变成了宋体以外的字体。后来我养成习惯装完字体先在系统字体册里复制准确名称再粘贴进 CSS不手打。另一条血泪经验是改主题前一定备份.user.css。有次直接改主 CSSTypora 升级后主题被覆盖所有调参白做。现在所有个人改动只写在.user.css里主 CSS 保持原样升级也不怕。希望帮到你。本文还有配套的精品资源点击获取