first commit

This commit is contained in:
CrazyJasonwell
2026-07-23 20:36:13 +08:00
commit 513b68be8c
7915 changed files with 2642530 additions and 0 deletions
@@ -0,0 +1,53 @@
---
title: (5)韩信作战无人能比做人不能比人_长空星照_新浪博客
updated: 2025-09-22T13:27
created: 2016-02-12 03:04:45Z
source: http://blog.sina.com.cn/s/blog_7e84ef460102uz0q.html
---
韩信作战无人能比做人不能比人
韩信是汉初著名的军事家,是刘邦手下的“三杰”之一,刘邦评价他:“统帅百万大军,战则必胜,攻则必取”,的确是非常到位。然而,这样一位盖世军事奇才,先是被降爵,最后被灭族,竟然落得了一个凄惨的下场。这当中当然有刘邦残忍狠毒的性格以及刘氏天下的政治需要,但是却有一个问题,除了后世之人给与他极大的同情之外,当时的人为什么就没有多少反映呢?与他形成鲜明对比的是,彭越也被刘邦灭族,并下令不准给他祭奠,可是那个栾布竟公开违抗皇命,大大方方地来到挂着彭越人头的城门下给彭越汇报出使情况。难道韩信就真的比不上一个彭越?说起来,韩信这个人,作战真是无人能比,但要是说起做人来,的确是有很多不及人的地方。
**韩信作战无人能比**
韩信原来是项羽的部下,可是项羽这个人过于相信勇力,对于一些智谋之士不太感冒,比如说他手下只有一个谋士范增,还不能合作到底。即便是对于武将,他也用熟不用生,只用现成的,看不到潜力股。韩信就是这样从他那儿跑到刘邦阵营中去的。在刘邦那儿,韩信也不受重用,他也想跑,可是刘邦这个人敢用人,他手下的人也愿意给他推荐人。因此,先后有夏侯婴和萧何向刘邦推荐,韩信终于当上了大将军。
韩信绝对不是夸夸其谈之辈,在他得到了刘邦军事指挥权以后,马上来了一个“明修栈道暗度陈仓”之计,这给项羽以及当时所有的人一个想不到。别人想不到不要紧,项羽安排看住刘邦不让东进的三个秦地之王想不到可就惨了,没有多长时间,这秦地就完全成了刘邦的地盘。要说这三个王,并不是吃素的,他们手下拥有的秦兵,更是天下最能打仗的战士。尤其是那个章邯,那可是秦朝最后一员猛将,陈胜、项梁、魏王咎都是被他打败的。可是到了韩信这儿,虽说也制造了一点儿麻烦,但总起来还是属于不堪一击之类。
刘邦军队攻进彭城,项羽一个回马枪杀来,刘邦立刻大败而逃,幸亏是韩信收集溃散的人马,在荥阳与刘邦会和并摧垮楚军,项羽这才不能西进,并由此形成了楚汉相对峙的局面。有了这样一个暂时喘息的机会,刘邦派韩信去攻打魏王豹,三个月不到的时间,韩信就收复了魏地,俘虏了魏王豹,顺便打败了代国。韩信是带着不多的军队去攻打魏国的,打下了这些地方,韩信的军队反而壮大了。这时候,刘邦却不行了,所以,一下子就把韩信的精锐部队给抽走了。就是在这种情况下,韩信率领着一支几乎是临时拼凑起来的队伍,“背水一战”,一个早晨就打败了赵国。赵国灭亡,燕国胆寒,马上投降。一战而得两国,真是奇迹。韩信收编了赵国的军队,在保卫赵地和抵御楚国攻击的作战中又锻炼了军队。可是刘邦却故伎重演,又一次调走了韩信的精锐部队去保卫荥阳。这还不算,他还让韩信重新招兵买马去攻打齐国。攻进齐国,韩信并没有费多大力气,因为那个“高阳酒徒”郦食其已经说服了齐王投降了汉王。但是,齐王田广和前来救援的楚国大将龙且带来的军队号称是二十万,即便是这个数字有虚假的成分在其中,但肯定要比韩信临时征集来的人马多得多。就是在这样又一次力量不对等的战争当中,韩信一战打败了齐楚联军,杀死了龙且,俘虏了楚国全部的士兵。剩下来的事情就简单了,当韩信率领着汉王调集来的大军,在数量上占有绝对优势的时候,项羽这个楚汉时期最劲的“强弩”,也到了“之末”,只能是听着“四面楚歌”,饮恨乌江。
如果是临阵厮杀,从秦到汉这一时期没有人是项羽的对手,韩信也不例外。但是,战争不仅仅是列阵厮杀,即便是两军交战,也不是你捅我一枪,我还你一剑这般简单。因此,在这一时期,韩信打仗无人能比。和项羽相比,刘邦彭城兵败,是韩信止住了溃败,抵挡了项羽;刘项决战,总指挥就是韩信,十面埋伏更是战争史上的大手笔。除此之外,楚汉相争时期有名的将领几乎都是韩信手下败将,如章邯、龙且、李左车、陈余以及夏说、魏豹、赵王歇之流。还有,刘邦手下第一武将功臣曹参就是韩信攻赵占齐的部将。最关键的是,韩信每一次重大的胜利,几乎都是在白手起家的情况下取得的。所以说,在那个时代,韩信打仗无人能比。
**韩信做人不能及人**
不过,韩信这个卓越的军事家被杀,让我们现代人无比同情,可在当时却并没有引起多大波澜。尤其是他死的情形,吕后一个决定,萧何一个“请”字就把他搞定了。问题是,韩信一个堂堂的诸侯王,一个领导指挥过刘邦手下几乎所有将领的大将军就这样死了,几乎就没有弄出一点儿动静。司马迁更是把他定为“淮阴侯”,这不太符合《史记》的行文风格。比如说,项羽是个王,因为这个王有封王的权力,他还是被列在本纪当中;再比如吕后,因为她是实际上的皇帝,所以事迹也在本纪当中记载。更有甚者,韩信在做楚王时,有人说他谋反,刘邦身边的将领们竟然一致地表示要出兵杀了这个“竖子”,也就是说他是个小人。那么,究竟是“墙倒众人推”还是韩信做人真有问题呢?答案应该是后者。
且看他做的几件事情。
韩信接到命令攻打齐国,当他还没有进入齐国境内,就已经知道郦食其说服齐王田广归顺刘邦了。韩信也曾经打算不再进攻齐国,可是有一个说客蒯通给他讲了一番嫉贤妒能的理论,他就把齐国给攻下了。结果是,这个郦食其被认为是刘邦派来使诈的,齐王把他投进油锅里煮了。干出这样的事情,做人就很有点儿问题了,即便是军事进攻齐国,能不能多少考虑一下郦生的安危?哪怕是给他一个信儿也好!当然了,从刘邦集团长远的利益考虑,攻下齐国比齐国归顺要好,因为归顺的这个齐国很有可能再反水。但问题是,这个韩信占有了齐国,同样是向刘邦要了一个王,项羽以及上面提到的那个蒯通同样要他自立。把他人的成果换一种手法变成自己的,然后拿着这个向刘邦要王,这不是站在别人的肩膀上向上爬,而是垫着他人的尸体让自己站得更高。
打败项羽,刘邦当上皇帝,韩信改封为楚王。刘邦下令,在全国大力搜索项羽的部将,钟离眜这种高级将领,更是重点通缉对象。逃亡之中,钟离眜自己觉得和韩信要好,就避难来到了楚国。有人告发韩信造反,刘邦就以巡游为名,要逮捕他。韩信想发兵造反,又觉得自己没有罪,想朝见刘邦,又害怕被擒。有人给他出了一个主意,让他杀了钟离眜再去见刘邦,这样刘邦会高兴,消除对他的疑虑,他的祸患就解除了。韩信是怎么做的呢?他是去和钟离眜商量!钟离眜骂韩信说:“你不是一个厚道的人!”然后自杀。如果说,钟离眜是因为韩信暗示自己去死而责骂韩信的话,说韩信不厚道其实是非常轻的。按照古人的做人标准,韩信这种行为绝对不是君子所为。就韩信来说,他可以拒绝收留钟离眜,还可以把钟离眜押送给刘邦处置,这样做虽然不够朋友,还可以说是一种“忠君”的坦荡行为,收留了人家,到了生死抉择的时候再去和人商量,这不是明摆着要人家去死吗?既然收留了,韩信还是有两种选择的,一是把他送走,不管是北去匈奴还是南去百越;二是直接向刘邦求情。可惜,这些“长者”的行为韩信都没有采取,恰恰选择了小人行为。
并不是说,我们因为钟离眜的一句话就把韩信一棍子打死,这里有一个对比,那就是和钟离眜地位相当,遭遇相同的季布。刘邦痛恨季布超过了钟离眜,他曾经下令,谁敢收留他,灭三族。季布逃亡到了周家,周家知道自己的能力有限,在征得季布同意后,就把他以买卖的形式送给了朱家。朱家把他暂时放在干农活的奴役当中,然后就找汝阴侯夏侯婴求情。夏侯婴找机会给刘邦说了,季布得到了赦免,后来还做官做到了河东郡守。两相比较,韩信上比不了一个夏侯婴,下比不了一个乡间财主。
韩信被刘邦在云梦泽擒获后,由楚王降为淮阴侯,从此经常托病不参加朝见。他曾经拜访过樊哙,樊哙受宠若惊,跪拜迎接,自称臣子。出门后韩信竟然说,我这辈子竟然要和樊哙这等人为伍了。人家对他的尊重,换来的竟然是他对人的蔑视!撇开樊哙这个人是刘邦的连襟不说,人家毕竟也是一代英雄豪杰。论资历,韩信还是一个执戟郎中的时候,樊哙已经是一个列侯了。论豪情,樊哙勇闯鸿门宴,保护刘邦,斥责项羽,这是何等的英雄!为此,项羽都称之为“壮士”。和这样的人为伍,即便他是一个普通士兵,又会辱没你什么?
韩信做大将军,是萧何向刘邦极力推荐的,不管怎么说,韩信能够发挥自己的聪明才智,缺不了萧何的举荐之功。后来吕后要杀韩信,让萧何去请,萧何请了,韩信进宫,吕后没有费多大劲儿就杀了他。后人将这种事情总结为“成也萧何败萧何”。为什么没有多少人为这件事情诟病萧何?可见韩信这人为人并不咋样!还有曹参、灌婴等人,他们跟随着韩信攻赵掠代经营齐国,可以说是曾经生死与共,韩信死后,为什么连一声叹息都没有?倒是刘邦听说韩信死了,在高兴之余心里有了那么一丝怜悯。不过,这种怜悯不是源于平等的人与人之间的关系,而是一个皇帝对一个大才之人这般下场的俯视,与韩信的为人无关。
当然,韩信是不是该杀,这和为人好坏无关。但一代豪杰除了军事才能被人敬仰,其他再没有供人称道的东西,这是不是与做人不能及人有关呢?
博客首页
[![韩信作战无人能比做人不能比人](../_resources/4f26b220d15f7af8f3feb5192d6b1e81.png)](http://photo.blog.sina.com.cn/showpic.html#blogid=7e84ef460102uz0q&url=http://album.sina.com.cn/pic/002jEnWKzy6KHcjp4uM2c)
文史博客史话
[![韩信作战无人能比做人不能比人](../_resources/0391b3aee68495c9a1486721bb462d33.png)](http://photo.blog.sina.com.cn/showpic.html#blogid=7e84ef460102uz0q&url=http://album.sina.com.cn/pic/002jEnWKzy6KHckvEBR53)
新浪历史精选
[![韩信作战无人能比做人不能比人](../_resources/3d045b93716ed28dc745e648b3428a26.gif)](http://photo.blog.sina.com.cn/showpic.html#blogid=7e84ef460102uz0q&url=http://album.sina.com.cn/pic/002jEnWKzy6KHclvpbRdb)
草根博客讲坛
[![韩信作战无人能比做人不能比人](../_resources/3d045b93716ed28dc745e648b3428a26.gif)](http://photo.blog.sina.com.cn/showpic.html#blogid=7e84ef460102uz0q&url=http://album.sina.com.cn/pic/002jEnWKzy6KHcnjuj32d)
+24
View File
@@ -0,0 +1,24 @@
---
created: 2025-08-30T11:45
updated: 2025-09-22T13:27
---
# 1Day planner
- [ ] 安装Joplin 21:00
- [ ]
# 2 记录
- 学习obsidian附件文件组织和配置
- 安装calibre插件,可以链接himan.picp.net:9089(calibre-jeff/Jeff!!),但是阅读书籍时候跳到浏览器,不是在obsidian工作台内,体验感不好,可能链接calibre本身server没有这个问题
-
- 测试
- DevonThink 输入
# 3 学习
- 学习obsidian提醒、任务管理、模板使用
-
# 4 问题
-
-
+93
View File
@@ -0,0 +1,93 @@
---
created: 2025-09-01T12:35
updated: 2025-09-02T21:14
---
根据您提供的8月份工作日记内容,我为您整理了一份详细的工作总结:
### 2025年8月工作与技术实践总结
#### 一、技术实践与系统管理
1. **数据备份与同步**
- 成功配置Mac M1时光机备份机制(8月1日)
- 建立DSM/USBShare5/myData集中备份体系(webdav路径配置)
- 测试多种同步方案:Syncthing点对点同步、DT备份到DSM
2. **Docker与容器管理**
- 解决Mac mini Docker异常(内存/磁盘读取问题)
- 飞牛系统Docker容器自启动问题记录
- 发现优质Docker项目:code-server/cloudbeaver/uptime-kuma(8月29日)
3. **媒体中心建设**
- 购买Plex会员(148元/年),测试远程播放功能
- 解决Plex外网端口映射问题(UPnP配置)
4. **网络优化**
- 优化mihomo配置(适配不同内核版本)
- 确认家庭宽带端口限制(80/443等常用端口被封)
#### 二、工具与效率提升
1. **Obsidian相关**
- 购买OBSheetPlus插件(32元),实现表格导入导出
- 学习Git插件使用方法(仓库初始化流程)
- 发现优质模板库:kepano-obsidian
2. **AI工具探索**
- 测试多种本地AI部署方案(OLLAMA/GPT4ALL/LM Studio)
- 记录deepseek-V3模型参数(377G显存需求)
- 评估多个OBAI插件(Smart Connections等)
3. **其他工具**
- 购买简悦高级账号(11元),配置OB同步
- 发现multipost多平台发文插件
- 搭建Flare导航页(192.168.1.181:8280)
#### 三、待解决问题清单
1. **技术难题**
| 问题描述 | 记录日期 | 状态 |
|---------|---------|------|
| Mac mini Docker运行不稳定 | 8月1日 | 待解决 |
| Plex外网映射不稳定 | 8月29日 | 部分解决 |
| OB-OnlyOffice集成故障 | 8月31日 | 未解决 |
| Alist目录映射异常 | 8月31日 | 未解决 |
2. **系统优化**
- Openlist修复(8月31日待办)
- Wordpress+Onlyoffice集成(8月31日待办)
- 浏览器剪藏功能完善(MSN页面问题)
3. **日常管理**
- 英语/打字等日常训练未形成规律
- 9月工作计划尚未制定
- 博客发布计划未执行
#### 四、经验与发现
1. 实用技巧:
- 端口检查命令:`netstat -tunlp | grep 端口号`
- Docker汉化方案(GitHub-asxez项目)
2. 优质资源:
- 天气API:weatherapi.com(免费版可用)
- 技术博客:苏洋的Docker相关项目
3. 重要提醒:
- WebClipper同步时需注意路径问题
- 插件配置涉及本地路径时跨设备同步会异常
#### 五、后续行动计划
1. **技术方向**
- 优先解决数据备份稳定性问题
- 完善家庭媒体中心建设
- 深入研究本地AI部署方案
2. **效率提升**
- 建立日常任务打卡机制
- 制定9月明确的技术探索计划
- 对已购服务进行深度使用评估
需要针对某个具体问题深入分析或制定解决方案,可以告诉我进一步展开说明。建议将本总结保存为[[August_Diary_Summary_Report]]以便后续参考。
#### Sources:
- [[August_Diary_Summary_Report@20250901_121407]]
- [[../80-归档/81-工作日记/202507/2025-07-15]]
- [[晚风吹得很舒服,一个人在路上惬意地走着! (2025-08-17 19-02)]]
+133
View File
@@ -0,0 +1,133 @@
---
created: 2025-08-30T10:17
updated: 2025-08-31T16:10
---
这是一个草稿本,用来替代iAWriter
docker run -it --privileged --pid=host debian nsenter -t 1 -m -u -n -i sh
docker cp /Volumes/DataRaid/Docker/mihomo 6306cc3ee15f:/mihomo
docker run -d -p 8080:80 --name myNginx -v nginx:/usr/share/nginx/html nnxn
群晖:sudo chgrp administrators /var/run/docker.sock
飞牛:sudo chgrp Administrators /var/run/docker.sock
草稿 非MD 弹窗口
好的,制定计划是达成目标的关键一步。一个清晰、可行的计划能大大提高效率,减少迷茫。
这里为您提供一个**通用且强大的计划制定框架**,无论您的目标是关于工作、学习、健身还是个人生活,都可以套用。您可以根据自己的具体情况进行调整。
### **制定计划的黄金五步法 (SMART原则为基础)**
---
#### **第一步:明确目标 (Define the Goal)**
首先,你需要一个清晰的目标。一个模糊的目标(如“我想变好”)是无法制定计划的。请使用**SMART原则**来精炼你的目标:
* **S (Specific - 具体的)**: 目标必须明确具体,不能笼统。
* **错误示例**: “我要学好英语。”
* **正确示例**: “我要在6个月内达到能够无障碍阅读英文技术文档和进行日常口语交流的水平。”
* **M (Measurable - 可衡量的)**: 目标需要可以量化,以便跟踪进度。
* **正确示例**: “雅思考试达到6.5分” 或 “词汇量增加到8000词”。
* **A (Achievable - 可实现的)**: 目标要有挑战性,但也不能不切实际。
* **错误示例**: “我一个月内从零基础变成英语大神。”(不现实)
* **正确示例**: “我三个月内完成新概念英语第二册的学习。”
* **R (Relevant - 相关的)**: 这个目标是否与你的更大、更长远的规划或人生价值相关?
* **自问**: “学好英语是为了什么?”(例如:为了晋升、出国旅行、阅读第一手资料)
* **T (Time-bound - 有时限的)**: 设定一个明确的截止日期。
* **正确示例**: “在2024年12月31日前完成目标。”
**经过SMART原则梳理后,你的目标可能是:**
“在接下来的3个月内(T),通过每天学习1小时(M/A),将我的Python编程能力提升到可以独立完成一个简单的数据分析项目(S),以争取年底的转岗机会(R)。”
---
#### **第二步:分解任务 (Break It Down)**
将宏大的目标分解成一个个小而可操作的任务。这能避免你感到不知所措。
* **方法**:
1. **列出主要阶段**: 将实现目标的过程分为几个大的阶段。
2. **细化成每周/每日任务**: 将每个阶段进一步分解为具体的、每周甚至每天要做的行动。
* **示例 (以“3个月学会Python做项目”为例)**:
* **阶段一:基础学习 (第1-4周)**
* 任务: 完成XX在线课程的Python基础语法部分。
* 周计划: 每周完成3个章节。
* 日计划: 每天下班后学习30-45分钟,并完成配套练习。
* **阶段二:核心库学习 (第5-8周)**
* 任务: 掌握Numpy, Pandas, Matplotlib。
* 周计划: 每周深入学习一个库,并做小练习。
* **阶段三:项目实践 (第9-12周)**
* 任务: 找一个真实的数据集(如Kaggle上的入门数据集)完成一个完整的分析报告。
* 周计划: 第一周数据清洗,第二周数据分析,第三周数据可视化,第四周撰写报告。
---
#### **第三步:资源整合与风险评估 (Resources & Risks)**
思考你需要什么,以及可能会遇到什么困难。
* **所需资源**:
* **时间**: 每天/每周能投入多少小时?具体什么时间段?(例如:每晚9点-10点)
* **工具**: 需要什么软件、书籍、课程、资金?
* **人力**: 是否需要找人指导、监督或组队学习?
* **潜在风险与对策**:
* **风险**: 加班导致计划中断、 motivation 下降、遇到技术难题卡住。
* **对策**: 预留出“弹性时间”(如每周留一天缓冲);加入学习社群寻求帮助;设定小的奖励机制(如完成一周任务就看场电影)。
---
#### **第四步:执行与跟踪 (Execution & Tracking)**
计划的价值在于执行。
* **选择跟踪工具**: 选择一种你喜欢且方便的方式记录和跟踪进度。
* **数字工具**: Notion, Trello, 滴答清单, 手机备忘录,日历提醒。
* **物理工具**: 手账本,白板,便利贴。
* **定期复盘**:
* **每日/每周检查**: 今天/本周的任务完成了吗?为什么没完成?如何调整?
* **调整计划**: 计划不是一成不变的。如果发现原计划不切实际,要灵活调整,而不是直接放弃。
---
#### **第五步:庆祝与奖励 (Celebration & Reward)**
不要忘记在达成里程碑时奖励自己!这能为你提供持续的动力。
* 完成一个阶段后,给自己一点奖励(吃顿大餐、买心仪的东西、休息一天)。
* 最终达成目标后,进行一次大的庆祝,并真诚地感谢努力的自己。
### **计划模板(供您直接使用)**
**目标:** [用一句话写下你经过SMART原则梳理后的目标]
**截止日期:** [年/月/日]
| 阶段 | 时间范围 | 关键任务 | 完成状态 | 备注/困难 |
| :--- | :--- | :--- | :--- | :--- |
| **阶段一:** [例如:基础准备] | [第X周 - 第Y周] | 1. [任务1] <br> 2. [任务2] | □ 未开始 <br> □ 进行中 <br> □ 已完成 | |
| **阶段二:** [例如:核心执行] | [第X周 - 第Y周] | 1. [任务1] <br> 2. [任务2] | □ 未开始 <br> □ 进行中 <br> □ 已完成 | |
| **阶段三:** [例如:收尾复盘] | [第X周 - 第Y周] | 1. [任务1] <br> 2. [任务2] | □ 未开始 <br> □ 进行中 <br> □ 已完成 | |
**所需资源:**
* 时间:[例如:每周一、三、五晚上8-10点]
* 工具:[例如:XX教材、XX软件、XX网站会员]
* 其他:[例如:寻找一个学习伙伴]
**潜在风险与对策:**
* 风险1:[例如:临时加班] -> 对策:[利用周末补上,或调整本周计划]
* 风险2:[例如:遇到难题拖延] -> 对策:[规定自己卡住15分钟就上网查或提问]
**奖励机制:**
* 完成所有周任务: [奖励:看一集剧]
* 完成一个阶段: [奖励:买一本新书]
* 最终达成目标: [奖励:一次短途旅行]
---
**最后请记住:最好的计划是那个能被有效执行的计划。** 不要追求完美而迟迟不开始,**先完成,再完美**。现在就开始填写这个模板吧!
祝您成功!
@@ -0,0 +1,14 @@
---
excalidraw-plugin: parsed
tags: [excalidraw]
---
==⚠ Switch to EXCALIDRAW VIEW in the MORE OPTIONS menu of this document. ⚠== You can decompress Drawing data with the command palette: 'Decompress current Excalidraw file'. For more info check in plugin settings under 'Saving'
## Drawing
```compressed-json
N4IgLgngDgpiBcIYA8DGBDANgSwCYCd0B3EAGhADcZ8BnbAewDsEAmcm+gV31TkQAswYKDXgB6MQHNsYfpwBGAOlT0AtmIBeNCtlQbs6RmPry6uA4wC0KDDgLFLUTJ2lH8MTDHQ0YNMWHRJMRZFAEYAdjCyJE9VGEYwGgQAbQBdcnQoKABlALA+UEl8PGzsDT5GTkxMch0YIgAhdFQAayKuRlwAYXpMenwEEABiADMx8ZAAX0mgA
```
%%
+83
View File
@@ -0,0 +1,83 @@
---
excalidraw-plugin: parsed
tags: [excalidraw]
---
==⚠ Switch to EXCALIDRAW VIEW in the MORE OPTIONS menu of this document. ⚠== You can decompress Drawing data with the command palette: 'Decompress current Excalidraw file'. For more info check in plugin settings under 'Saving'
# Excalidraw Data
## Text Elements
M1:StudyDiary ^I2hII7F6
remotely save ^yPgchcYF
DSM:DataSpace ^8Sql8M7H
DSM9161
DataSpace/myObsidian ^if9jW7qZ
Duplicati ^SI4MYeJC
周日下午1点备份7个循环 ^z64EopAV
%%
## Drawing
```compressed-json
N4KAkARALgngDgUwgLgAQQQDwMYEMA2AlgCYBOuA7hADTgQBuCpAzoQPYB2KqATLZMzYBXUtiRoIACyhQ4zZAHoFAc0JRJQgEYA6bGwC2CgF7N6hbEcK4OCtptbErHALRY8RMpWdx8Q1TdIEfARcZgRmBShcZQUebQBGAFYEmjoghH0EDihmbgBtcDBQMBKIEm4IAFkANQB9CgBRAGl4gCV6ZwA2AHZE+NIAThhNAEdMABVUkshYRAqgojkkflLM
bmcAFg3kzviAZh4ADnieRJXIGHWeI+1u+IAGAb3e84gKEnVuJI3te/iBxJ7E5nQqQSQIQjKaTcQ73bSJbrHU6vazKYLce6vZhQUhsADWCAAwmx8GxSBUAMTxBDU6lTUqaXDYPHKXFCDjEYmk8kSHHWZhwXCBbL0yAAM0I+HwAGVYOiJIIPKKINjcQSAOofSTcPiglU4/EIWUweXoRXlV5sqEccK5NDxV5sQXYNSXe33TF61nCOAASWIdtQeQAuq8
xeRMv7uBwhFLXoQOVgKrh7sq2RybcxA8VptB4OJeKCAL5YhAIYjcToAjaHQ4DXW5xgsdhcNCA15N1icABynDEX26ewG20HsPjzAAIukoOXuGKCGFXpphByGsFMtlAzG43qhHBiLgZxX7b1OokNvdjolOocNq8iBw8dHY/h72xmbO0PP8GFCiXCjmkDlBIvq1NKTTquqhwToSACaGzjAAqtUjAbA0IwDNKyqzAWEBCriVCvGsaDOEc8TaIcBz3ECy
J6m6qDOPEdbaFRNEgrm7zEJ89rxN08LdBsPBMS8ergpC0JoHCTwibmqKmp6uaqoaXJkpStI0sseqMsy3rspyJKqby5AcAKQpZFAyoSlKxqmiqJIWnqSkalqOpYgaBI2bh5oVpawjWraXyOs6rpfB6ry6X6Ab5KGerhrgkbHqg26vnqCbEEmEi4PEaYrsQmbZqCMz5jqxalp+qB7D0PQDJRnQdkwXatrwfz1c2PZ9gW8QPA8iTDjwCmlIQk7TuV36
LlpuVrhk5lbi+rx7geR4Dte54PL0WwNqUD5PmgyVvh+iVjQgrxwGwCY5PkhUFNMJQDdM9yFTFN3XTdXV8QignCexN1Sc8iSPaCT1baEUDEvo+hqEeAAKZ0irtc2OVEpBQAAQmlCbKM+O65lkxBoxyGPcIBkDpBuUBRhIKMAPKwSj9AwBwhLKLBAxGMoTSdHiGy4Ih9AAOKiuK75CIGcL3L1nTPPWnR/FWpztoVEDKLgcBfHEGwy9J/3TP+ilI1AA
CCpAEeCuCJXteq40bJshIleHG2whGW/gy4UKNC4IH+KyAWUdu+jwki+r63QAGKdNhxW8lgFlEesgmHNoAyS3c9w8DLQ77K89GMQMfH1knhwyaUnHcagJw/F18SS3seweoiwKvGJUIWWg1zaJLZGnB63fUXVepyQWd36mqRIGTy6BUhpdJLkyLLpvp3IVHyJmCsKMexZKMpyl59k+YjI+alx2qt25I+eRU3k5X4kj5YFepOkyIXukPEX+oGIZhhGC
AU0lCO5mlGV0C4B4FfDMAV4bY1KGEcqDw9iwjgYcVqjUvhDiQS2XsHB+xoEluLbo9wNZDyGlOYIS0vweyXJNdcM0sYpVzAtQ8MDTyrQ9EJQ4fdczbRoftAkh1yF6hnJgFu6BKjxGQLKIQxAYATisKQS4lpKDjGjhUERYioASKkTIuRsVOBQGlIQIwnUE4PE6F3Hu3cjhhh0SHeKkp6LfRmNHA2RBlBNQgMEMU69GxMCgOYAgTjISuKgE6ZUehsi4
ATEwH+FtcxkkhAmAgijBHKNEeIyR0ihRaNkkIIJrRwj6ILDiIQx09QPgQAACQhM3L42hThewAqlO21Nab00ZszVm7NObc15gLV4OEKiBGwFEDgaJNK5mIgxJI5FugFyLhcK4PAfgaxrBsP6rwS7HzLjVCidckT2KkJUiSqBES3DgZ3RIZiHT92GfJU+ykx5qSnqMhks9dIchUuPaAxlTJr0spvc+Cpd7KicggQ+pdNoCHckabeF9AW+Wvrfe0QVH
6wFCi/NkkV35A3FF/KJf9BqJnGXhPYoC8rgNQMTPMcw0B7FKo5MsiUq4DABLsQ4Fi9SdhbDqe43Q0HtUwZ1IcewVn/HYYNYaJD3Y/mKbmZcekppk3foVYmQE/ZgQglBGC8EkIoQQGhDCWFzilD6ZlB2VBCq62mMq32FREJGDKd2IwAAZbsrRlDdgAFKaAGBwd1AANbs4x8D0AnILIqVKgGmogOawG819wMIZUwjYXVKpMSHpwiBtCtrvh4XOD2dS
Sg+2AugPmiFOhlIAFoACtsDdE6O6mUnQKBQ3KXzCctRsq9MjugAZQyRnKnGaRNh2gNjdDTteWiuZs68T2es0KcQZZJBMRsJlK6mWNwOUImWKJrmD1uQSd5Dz1LKm0nPXKB6jL8lXuZX51loUAqVHukFLkT770NP8s0sK9RWhvmSy5MTgooufuFdFb9oqf3it/c2eKgIEuTBsElCLyWK2NRVWlil6XcHObWTouway8qarxP9pQOV8qwWXGsAxvip0
IeKhApDUBHQoXKqhm5Lo3StSh6ASjDUqoqDAKGyhsCSGwLBEOUabpFhjbuON9Hp1niTZeRI14eUlITDtX+kDICkgOrmqV+aigNL4wJoTImxOdvDVxpJscSI8F6PCJNhxzyOcojVLYWd1i8SHrOtAsITlMt6ncaqN5EGiQ3ZhoeA8MSPvPRPdS08tIvPnjFz5l6zIijDH8u9H6H2vuckfVyuWoUmh3jl3M37ENEcgA/F0gGy5hS9CBqKaAP6xRxVB
zTZRYOZQ2NUBDZLolQIw/aGqqcbynHBQwBqnLqV7JIxwDBZHvgd2C3eVKtH6OMYmsx6arGM2xsWowlaCnHPKfvGprhJTs2SvGrmARQiICBH0GwGc+AYAAB0TK4EYGmBRSiJCPee0EGAqBmBfaeULbIeiDFcssdkaxENXuYd6Y45xrixDZCYMqJsPj3D+JcRUCGxBiDoleKEqIETSA/wgCWstVaa11obU2ltbaO331IHEjgCS/vdoyID17IOwfKlw
NktguTWDQ7QIU6VW0IkVPEkI8itSSgWsLXbQ40oRj4EOJUboZSI4Wbu/2jzacanxA2kp3og4DiirmSRf4PxbODhWbMt4z7yMDASHcJOvcESjoOOu+XOoHenN2Rc1bskd1RcK8lyeR6Z46SS/ci9K80ueNKFZLexWYWlagZC0FGyJvAvfXZHPkByu/qRTV+iDw0U+lA81rFEA4oJQu//LrQDw5wrAVmVvg2YG7B4DVQuo78OhRC14tq82OpqzTtsL
Y9ZxzELo9d6XkBZWrhYxdPb0mDsJqO11I4Bxx8y8fL3rTV3eFSuR0kiQE5pSVGQBOQ8uBpTOnBw937N/0B34f0/qIr+mR38xQdEodOoPchx7gTFzkzFU5YcoB4dbEkd+EUcAkKh3E09IBsdfF8A8dAlglScdFwkbRKd2tM0qt2d/Aucv8IAf9H9n8AD+wUQRcxd8luApczsbQ5cql7QaltYwAVdDMJBbV7UnUXU3VPVvU/UA0g0Q1zNcJ8JHYjds
FyJbxVk6IPNfMFNF0J1i43ckg9hE5l1WEXcm5Dk4QO5dlt0+1JJosk9YtHlj1Esz07CUsU8fkMtb0s970HI9YD43dC9IVi9L44V/Ie9EV74ANq96tcxX4msgxG9m9IMz9Ot0pCVcBug+swikMbpKUCweA0M+8GVrgM4gQxx2UptOBuAR9yjJ8FtOpU5c4NYBhLxF8RpL8bsGRKEdst8NMyCIB6FZNE1k0WU01ztt8OEL9dMOjIBTpzpFVnpCowA7
pbpHpDUXpph9DDD6wvoeNzCj9gQAZphG98AQYwYIYZBywYZzpkjsQhRUZ0ZhkiZFZSZzIqcmk6YGYmYWY2YOYuYeZ+ZBYm9hZRYEhxYappka4mJ/h9gdDShlZVZ7QfgXNVDegCiSYOR8ZHBHjxjc87jrZHZTZSDXgrZTVCTkxI1iSXZHYV99NVc0DJAxRuhCRxgmhWgGg8QABFDgTQDkzQegMQSiDIuQ+YKUQgJYJQ3gA4eEVlaiBudQmzIECiFO
LWNZPQplROWtcdPZUwhXSA9uP4LUqwm5aPFw2PDSRwhPZwxeZPb5a9DwzPWyYIwrfPArXwt9LLEvHw0ocvLIyrCAarJ+OrWvPceveI8DFvHEmDVI5MQ4TIgqHIlDfInWMqBlOBauYcY/TAiogjTOGoxqOoyseuJlM3GjJfDbPhGVLohVZIgYw7eTLqQSUdFTDhMY3o7hGk5Xb2QQ9AQgMUAYStdUboEYctfXXCQ3azXga8X4KA9zO3XOX4RzFUvU
bzMuBEBIZlC8EdGuM8TM/ZQPGbYdFEvZSLGwk060+wuPBLS0vSZLZeW09LDeTwx0z9N0vLMFR9IIl870vyH9X0yvQMmvYDOvOIlrXMRI3FDrABNIgYOMm4obVAZONhToAhUfe0LdPM9Bafe0RzP4b4XcohNoqY1fCAdfYgeVahSM/omTOs1aI4WU5sk/dTAbc/HTMhK/ZA6gn/SjXYD7P/F/N/BQfQGAKmewEgJwH7CgRJe7LiqueIXi+ggSoSkS
hwcSuA0Ar4CuLWGA7uP04AuHGxRHNsa/Q2VHNAhADxLHbxbA3ApefAvUMnIgyJIktnDnKg6S+/biuSjgPihghAQS4S0SxwawIXZgvJCXVAdg1TTgsLHgpXfgrs/+O2X1R1aoDYNgaUCgA2QgbsJoRIIOStWoKAVoTQaoWCUc/pBAQZSLCcwcCiBZYwvZKdZC9uC8Gc5cvQx4BISiXqNQ3MHU7gOBFiZ3Y8yPU8180ec8iAM0+LGVJwm8lwu8q9B8
sCzLLw7LL0iFPw/LF9caz80vB7H8irf82rQChrYCzFcMpIyiqC5MA2WCtAClFDGlZMulGBKiASRIWsVC3gBfDC0jAsIEblLYfBVoiVdo4i0i8i3bIMJVRY3IpebjOGotCAaUX0DYSoWCBAd1QkcTHWKTOhaivfesngGuBEG3NxVs5itxSYti38Ts+pRKioVG9GzG7G8qqOKzPUcZIdWuGWQEWSkxLqWciZNcmZGdN3W8U3JlBZaWS3Y4APbgyco0
3dM8wyC880+PU9eayaxa1PG9B0krDa4eQ0F0na3PM+D0p0srQ6ivCI5FKI4MjFMDVrCDCCvom6zKFGe6ts16xKfqfBJ3OWb6oScPYjbMgsxE1hPYRIEm8mgisGoipjDfbo2aDrWsom2i0m2tDgpi6Dam1ihjCso1bnGgvcIgPAHxCSqSioCcMu3xSutS1g1uIePS+AgyuxYymyiQdHGcckVqHHPxUyiQQnYnd/ByinKnZK1K9KzK7K3K/Kwq4q0q
5UWJSg/Aau2/OuiuwgEKnJMKgpUgIpDg8pGKsuXg2k7siAIwZChoJ0A2XrYUjmjAiAcZWtFiWuesEOtaPoYW0ifYYdXq3Q7asuf+/BLuExH3M3cm/q+0OINhfY2EvCUa1AIeYFGPOLd/E9V5BeNW1w+85+jPPao24FU23gD8y2r8svG2v8u2qvVFICkMkChItrZIj2oBHGrvUlLIqm6BRKaZSWJ4JiXcubKogYfDCOsuG8KWUdE4UG5fcGpOsizf
VOvo9O5aYm/4VhHO5I7THNWm4iw3CQQACxVABT00AGg5QACWV4hABOh0AHBNQAX7luhAAqOUACr9QAeucq6S7THLGbGHHnH3HLIQCm66salmi2qwKrF26kDbsUD8cJB0DLLkZrKh70AglVYCCwkJ7nKYkKD4l16vHzGrG7HHHXGPGmC97xcD6j6oqT79yz64qBDGaJBJABhcAOSYB6AoYoZ2bUnEaxkrgpTNZAHbcRaE4TE6xIDEGVzdyYGlarlr
CUHbDJrprMG5q3kFqvklqCHVrnz9qSH/DyG1rPS95rb4Vbb/17b6GzrGGLqXaIyfa29ozMpEhvaeH4KawqwjDZG/qmo9hxGsKy5EQtgF0Fk5H6NIrKzttqzKK1GTx998EcNdhtHKLdGV9jKKhPHqDAnIdgn+o4CEDDLUA9k7su70Ae7Md+7knUDh6SBR6QlCCsmKgacK1q1a161pRG1m0ylW120V7cnOd8msXynRd962DD7iLSkuDDlFc+DJMwAn
o8I4A4BZQGEnijVwRMg0DA8VgGBCAEAKAUY1mcGPkKQxQzXzX6QIBsARA15fQZx9BZQR50GHCdXrXjZXj7XDXrz1mdbNm9bXWbWPWMgQ4dnDaTnIA3XbX7XHWTaDnCgrXA3sg7WMgY2PIKGc8E33Wk37XWhqHAwiNM2o2MgqZIirnShI2g39AQ5ImEcO742K3s3g2gnwq8X63E3yZ7WpLSW3FzK09C3K2VXkZ8SKAyScT+3G39AGgORh3R2I0CJL
WG2O2Mhh3xgu0Dq9IF323k2q2v5c3TQBsVRsBcQpRfVKxxZ4QdXmAj2SR8Ayq0AawE56qdj42jA2ADA1XiMCAikvh9Nx2l39Bc29JEN12ORLXWQSB1Lm6dXwPiBZQEAESiXoP2diBKg2B0op3cBNBggFH42YOYsfYUYSQ7ZSBlBGQAAKISHlXgXiagajqjuERIAASmVFyWUFjCFH6VI9wAo9rlo5JsxElIE4Y+Y9/cXdTYQBLZ8U4BUZ1cSNyUTH
Z2xOyNKCyEw+w7FeqdzGwEWA0+Is501cl3FcdGyVKV09eH0CFAJFIG7AgzM71As9ICs4w6w/Kil1/bsErUqpyGlE5zgFQ/Q85xc5w9KCZB8UYHGDffwA/bDS8nSEGU5VJxFiCX0FXfDSptReC/T1xAdbi6k6ak2w4RBgNni/C8i5oT/HAF1ib0lHCCJkkyLCAA==
```
%%
File diff suppressed because one or more lines are too long
@@ -0,0 +1,12 @@
---
excel-pro-plugin: parsed
---
```sheet
{"id":"nnQIuU","sheetOrder":["A5lNUkxyLgkjgU1FqmVv1"],"name":"08-Inbox/Excel 2025-10-29 16.02.30.univer.md","appVersion":"0.10.10","locale":"zhCN","styles":{"IQvMUH":{"ht":2},"ckNucC":{"bd":{"r":{"s":1,"cl":{"rgb":"#000000"}},"b":{"s":1,"cl":{"rgb":"#000000"}},"t":{"s":1,"cl":{"rgb":"#000000"}},"l":{"s":1,"cl":{"rgb":"#000000"}}}},"AMb4X-":{"ht":2,"bd":{"r":{"s":1,"cl":{"rgb":"#000000"}},"l":{"s":1,"cl":{"rgb":"#000000"}},"b":{"s":1,"cl":{"rgb":"#000000"}},"t":{"s":1,"cl":{"rgb":"#000000"}}}},"ayX4MB":{"ff":"Arial","fs":11,"it":0,"bl":0,"ul":{"s":0},"st":{"s":0},"ol":{"s":0},"tr":{"a":0,"v":0},"td":0,"ht":0,"vt":0,"tb":0,"pd":{"t":0,"b":2,"l":2,"r":2}},"iRSjdX":{"ht":2,"bd":{"r":{"s":1,"cl":{"rgb":"#000000"}},"l":{"s":1,"cl":{"rgb":"#000000"}},"t":{"s":1,"cl":{"rgb":"#000000"}}}},"koag3I":{"bd":{"b":{"s":1,"cl":{"rgb":"#000000"}},"t":{"s":1,"cl":{"rgb":"#000000"}},"l":{"s":1,"cl":{"rgb":"#000000"}}}},"1lAEiw":{"ff":"Arial","fs":11,"it":0,"bl":0,"ul":{"s":0},"st":{"s":0},"ol":{"s":0},"tr":{"a":0,"v":0},"td":0,"ht":0,"vt":0,"tb":0,"pd":{"t":0,"b":2,"l":2,"r":2},"bd":{"b":{"s":1,"cl":{"rgb":"#000000"}},"t":{"s":1,"cl":{"rgb":"#000000"}},"l":{"s":1,"cl":{"rgb":"#000000"}},"r":{"s":1,"cl":{"rgb":"#000000"}}}},"jJAjt8":{"bd":{"r":{"s":1,"cl":{"rgb":"#000000"}},"b":{"s":1,"cl":{"rgb":"#000000"}},"t":{"s":1,"cl":{"rgb":"#000000"}}}}},"sheets":{"A5lNUkxyLgkjgU1FqmVv1":{"id":"A5lNUkxyLgkjgU1FqmVv1","name":"Sheet1","tabColor":"","hidden":0,"rowCount":1000,"columnCount":20,"zoomRatio":1,"freeze":{"xSplit":0,"ySplit":0,"startRow":-1,"startColumn":-1},"scrollTop":0,"scrollLeft":0,"defaultColumnWidth":88,"defaultRowHeight":24,"mergeData":[],"cellData":{"1":{"0":{"v":"编号","t":1,"s":"AMb4X-"},"1":{"v":"项目名称","t":1,"s":"AMb4X-"},"2":{"v":"金额 ","t":1,"s":"iRSjdX"},"3":{"v":"说明","t":1,"s":"AMb4X-"}},"2":{"0":{"s":"AMb4X-","v":1,"t":2},"1":{"v":"住宿","t":1,"s":"koag3I"},"2":{"s":"1lAEiw","v":2600,"t":2},"3":{"s":"jJAjt8"}},"3":{"0":{"s":"AMb4X-","v":2,"t":2},"1":{"v":"餐饮","t":1,"s":"koag3I"},"2":{"s":"1lAEiw","v":3900,"t":2},"3":{"s":"jJAjt8"}},"4":{"0":{"s":"AMb4X-","v":3,"t":2},"1":{"s":"koag3I","v":"参观","t":1},"2":{"s":"1lAEiw","v":3900,"t":2},"3":{"s":"jJAjt8"}},"5":{"0":{"s":"AMb4X-","v":4,"t":2},"1":{"s":"koag3I","v":"摄影","t":1},"2":{"s":"1lAEiw","v":500,"t":2},"3":{"s":"jJAjt8"}},"6":{"0":{"s":"AMb4X-","v":5,"t":2},"1":{"s":"koag3I","v":"纪念品","t":1},"2":{"s":"1lAEiw","v":1300,"t":2},"3":{"s":"jJAjt8"}},"7":{"0":{"s":"AMb4X-","v":6,"t":2},"1":{"s":"koag3I","v":"礼品","t":1},"2":{"s":"1lAEiw","v":6000,"t":2},"3":{"s":"jJAjt8"}},"8":{"0":{"s":"AMb4X-","v":7,"t":2},"1":{"s":"koag3I","v":"酒水","t":1},"2":{"s":"1lAEiw","v":2400,"t":2},"3":{"s":"jJAjt8"}},"9":{"0":{"s":"ckNucC"},"1":{"s":"ckNucC"},"2":{"s":"ayX4MB"},"3":{"s":"ckNucC"}},"10":{"0":{"s":"ckNucC"},"1":{"s":"ckNucC"},"2":{"s":"ckNucC"},"3":{"s":"ckNucC"}},"11":{"0":{"s":"ckNucC"},"1":{"s":"ckNucC"},"2":{"s":"ckNucC"},"3":{"s":"ckNucC"}},"12":{"0":{"s":"ckNucC"},"1":{"s":"ckNucC"},"2":{"s":"ckNucC"},"3":{"s":"ckNucC"}},"13":{"0":{"s":"ckNucC"},"1":{"s":"ckNucC"},"2":{"s":"ckNucC"},"3":{"s":"ckNucC"}},"14":{"0":{"s":"ckNucC"},"1":{"s":"ckNucC"},"2":{"s":"ckNucC"},"3":{"s":"ckNucC"}},"15":{"0":{"s":"ckNucC","v":"","t":1},"1":{"s":"ckNucC","v":"合计 ","t":1},"2":{"s":"ckNucC","f":"=SUM(C3:C14)","v":20600,"t":2},"3":{"s":"ckNucC"}}},"rowData":{},"columnData":{"0":{"w":74.75390625},"1":{"w":115.19140625},"2":{"w":117.41796875},"3":{"w":232.98046875}},"showGridlines":1,"rowHeader":{"width":46,"hidden":0},"columnHeader":{"height":20,"hidden":0},"rightToLeft":0}},"resources":[{"name":"SHEET_UNIVER_THREAD_COMMENT_PLUGIN","data":"{}"},{"name":"SHEET_RANGE_PROTECTION_PLUGIN","data":""},{"name":"SHEET_AuthzIoMockService_PLUGIN","data":"{}"},{"name":"SHEET_WORKSHEET_PROTECTION_PLUGIN","data":"{}"},{"name":"SHEET_WORKSHEET_PROTECTION_POINT_PLUGIN","data":"{}"},{"name":"SHEET_DRAWING_PLUGIN","data":"{}"},{"name":"SHEET_HYPER_LINK_PLUGIN","data":"{\"A5lNUkxyLgkjgU1FqmVv1\":[]}"},{"name":"SHEET_CONDITIONAL_FORMATTING_PLUGIN","data":""},{"name":"SHEET_CHART_PLUGIN","data":""},{"name":"SHEET_OUTGOING_LINK_PLUGIN","data":"{\"A5lNUkxyLgkjgU1FqmVv1\":[]}"},{"name":"SHEET_RANGE_THEME_MODEL_PLUGIN","data":"{}"},{"name":"SHEET_TABLE_PLUGIN","data":"{}"},{"name":"SHEET_NOTE_PLUGIN","data":"{}"},{"name":"SHEET_DEFINED_NAME_PLUGIN","data":"{}"},{"name":"SHEET_DATA_VALIDATION_PLUGIN","data":"{\"A5lNUkxyLgkjgU1FqmVv1\":[]}"},{"name":"SHEET_FILTER_PLUGIN","data":"{}"}]}
```
```multiSheet
{"tabs":[{"key":"sheet","type":"sheet","label":"Sheet"}],"defaultActiveKey":"sheet"}
```
File diff suppressed because one or more lines are too long
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
+328
View File
@@ -0,0 +1,328 @@
![xiaoya-alist](https://socialify.git.ci/xiaoyaDev/xiaoya-alist/image?description=1&font=KoHo&forks=1&issues=1&logo=https%3A%2F%2Fraw.githubusercontent.com%2FxiaoyaDev%2Fxiaoya-alist%2Fmaster%2Fassets%2Flogo.jpg&name=1&owner=1&pattern=Signal&pulls=1&stargazers=1&theme=Auto)
![](https://raw.githubusercontent.com/xiaoyaDev/xiaoya-alist/master/assets/image.png)
![](https://raw.githubusercontent.com/xiaoyaDev/xiaoya-alist/master/assets/image-1.png)
![](https://raw.githubusercontent.com/xiaoyaDev/xiaoya-alist/master/assets/image-2.png)
![](https://count.getloli.com/get/@DDS-Derek.xiaoya-alist.readme?theme=rule34)
- [main.sh](#mainsh)
- [使用](#使用)
- [功能列表](#功能列表)
- [相关地址](#相关地址)
- [通用兼容性测试报告](#通用兼容性测试报告)
- [Star History](#star-history)
- [小雅周边工具集合](#小雅周边工具集合)
- [感谢](#感谢)
- [捐赠](#捐赠)
- [许可证](#许可证)
- [附加条款](#附加条款)
- [免责声明](#免责声明)
## main.sh
> [!NOTE]
> 整合安装脚本,内置所有相关软件的安装。
### 使用
```shell
bash -c "$(curl --insecure -fsSL https://ddsrem.com/xiaoya_install.sh)"
```
**备用地址**
```shell
bash <(curl --insecure -fsSL https://ddsrem.com/xiaoya/all_in_one.sh)
```
```shell
bash <(curl --insecure -fsSL https://fastly.jsdelivr.net/gh/xiaoyaDev/xiaoya-alist@latest/all_in_one.sh)
```
```shell
bash <(curl --insecure -fsSL https://raw.githubusercontent.com/xiaoyaDev/xiaoya-alist/master/all_in_one.sh)
```
```shell
bash -c "$(curl --insecure -fsSL https://fastly.jsdelivr.net/gh/xiaoyaDev/xiaoya-alist@latest/main.sh)"
```
```shell
bash -c "$(curl --insecure -fsSL https://raw.githubusercontent.com/xiaoyaDev/xiaoya-alist/master/main.sh)"
```
### 功能列表
> [!NOTE]
> 数字代表先选x,再选x,再选x
>
> PS: 2 2 8代表先选2,再选2,最后选8
**普通功能**
```shell
———————————————————————————————————————安装———————————————————————————————————————
安装 小雅Alist -> 1 1
安装 Emby全家桶(一键) -> 2 1
安装 小雅元数据定时爬虫 -> 2 5 1
安装 小雅元数据爬虫(Web 版本)-> 2 6 1
安装/更新 小雅助手(xiaoyahelper)-> 3 1
安装 115清理助手 -> 4 1
安装 Portainer -> 5 1 1
安装 Auto_Symlink -> 5 2 1
安装 Onelist -> 5 3 1
安装 Xiaoya Proxy -> 5 4 1
安装 Xiaoya aliyuntvtoken_connector -> 5 5 1
安装 小雅Alist-TVBox -> 5 6 1
安装 LrcAPI -> 5 7 1
安装 CasaOS -> 5 8 1
——————————————————————————————Emby手动全家桶配置————————————————————————————————————
单独 下载并解压 全部元数据 -> 2 2 1
单独 解压 全部元数据 -> 2 2 2
单独 下载 all.mp4 -> 2 2 3
单独 解压 all.mp4 -> 2 2 4
解压 all.mp4 的指定元数据目录【非全部解压】-> 2 2 5
单独 下载 config.mp4 -> 2 2 6
单独 解压 config.mp4 -> 2 2 7
单独 下载 pikpak.mp4 -> 2 2 8
单独 解压 pikpak.mp4 -> 2 2 9
单独 下载 115.mp4 -> 2 2 10
单独 解压 115.mp4 -> 2 2 11
解压 115.mp4 的指定元数据目录【非全部解压】-> 2 2 12
单独 下载 蓝光原盘.mp4 -> 2 2 13
单独 解压 蓝光原盘.mp4 -> 2 2 14
单独 下载 json.mp4 -> 2 2 15
单独 解压 json.mp4 -> 2 2 16
单独 下载 music.mp4 -> 2 2 17
单独 解压 music.mp4 -> 2 2 18
单独 下载 短剧.mp4 -> 2 2 19
单独 解压 短剧.mp4 -> 2 2 20
选择 下载器【aria2/wget】-> 2 2 21
单独 安装Emby(可选择版本,支持官方,amilys,lovechen)-> 2 3
图形化编辑 emby_config.txt -> 2 4
小雅爬虫 立刻爬取指定目录 -> 2 5 4
小雅爬虫 容器定时爬取目录单独配置 -> 2 5 5
小雅爬虫 清理爬虫进程锁 -> 2 5 6
小雅爬虫 重置爬虫数据库 -> 2 5 7
一键升级Emby容器(可选择镜像版本) -> 2 7
开启/关闭 解压成功后自动清理 mp4 元数据文件 -> 2 9 1 1
一键清理当前所有 mp4 元数据文件 -> 2 9 1 2
关闭 Emby 6908 端口访问 -> 2 9 2
———————————————————————————————————————更新———————————————————————————————————————
更新 小雅Alist -> 1 2
更新 小雅元数据定时爬虫 -> 2 5 2
更新 小雅元数据爬虫(Web 版本)-> 2 6 2
更新 115清理助手 -> 4 2
更新 Portainer -> 5 1 2
更新 Auto_Symlink -> 5 2 2
更新 Onelist -> 5 3 2
更新 Xiaoya Proxy -> 5 4 2
更新 Xiaoya aliyuntvtoken_connector -> 5 5 2
更新 小雅Alist-TVBox -> 5 6 2
更新 LrcAPI -> 5 7 2
———————————————————————————————————————卸载———————————————————————————————————————
卸载 小雅Alist -> 1 3
卸载 小雅元数据定时爬虫 -> 2 5 3
卸载 小雅元数据爬虫(Web 版本)-> 2 6 3
卸载 Emby全家桶 -> 2 8
卸载 小雅助手(xiaoyahelper)-> 3 3
卸载 115清理助手 -> 4 3
卸载 Portainer -> 5 1 3
卸载 Auto_Symlink -> 5 2 3
卸载 Onelist -> 5 3 3
卸载 Xiaoya Proxy -> 5 4 3
卸载 Xiaoya aliyuntvtoken_connector -> 5 5 3
卸载 小雅Alist-TVBox -> 5 6 3
卸载 LrcAPI -> 5 7 3
卸载 CasaOS -> 5 9 2
——————————————————————————————————————系统工具——————————————————————————————————————
查看系统磁盘挂载 -> 5 8
———————————————————————————————————————其他———————————————————————————————————————
一次性运行 小雅助手(xiaoyahelper)-> 3 2
账号管理 -> 1 4
非内网IP访问次数查看 -> 1 5
```
**高级功能**
```shell
Docker启动容器名称设置 -> 6 1
是否开启容器运行额外参数添加 -> 6 2
重置脚本配置 -> 6 3
开启/关闭 磁盘容量检测 -> 6 4
开启/关闭 小雅连通性检测 -> 6 5
Docker镜像源选择 -> 6 6
非可选网络模式容器默认网络模式 -> 6 7
进入弃用菜单 -> 6 8
开启/关闭 使用宿主机7z命令解压 -> 6 9
```
**弃用菜单(此菜单下的功能不再维护,不建议使用)**
```shell
———————————————————————————————————————安装———————————————————————————————————————
安装 Jellyfin全家桶(一键) -> 6 8 3 1
安装 Resilio-Sync(单独) -> 6 8 2 2 1
——————————————————————————————Emby手动全家桶配置————————————————————————————————————
立即 同步小雅Emby的config目录 -> 6 8 2 3
单独 创建/删除 同步定时更新任务 -> 6 8 2 4
————————————————————————————Jellyfin手动全家桶配置——————————————————————————————————
注意:目前官方 Jellyfin 安装方案已经长久未维护!
如果您需要安装 小雅Jellyfin 全家桶,请使用 AI老G 的脚本安装,风险自担。
脚本命令:bash <(curl -sSLf https://xy.ggbond.org/xy/xy_install.sh)
单独 下载并解压 全部元数据 -> 6 8 3 2 1
单独 解压 全部元数据 -> 6 8 3 2 2
单独 下载 all_jf.mp4 -> 6 8 3 2 3
单独 解压 all_jf.mp4 -> 6 8 3 2 4
解压 all_jf.mp4 的指定元数据目录【非全部解压】-> 6 8 3 2 5
单独 下载 config_jf.mp4 -> 6 8 3 2 6
单独 解压 config_jf.mp4 -> 6 8 3 2 7
单独 下载 PikPak_jf.mp4 -> 6 8 3 2 8
单独 解压 PikPak_jf.mp4 -> 6 8 3 2 9
选择 下载器【aria2/wget】-> 6 8 3 2 10
单独 安装Jellyfin-> 6 8 3 3
———————————————————————————————————————更新———————————————————————————————————————
更新 Resilio-Sync(单独) -> 6 8 2 2 2
———————————————————————————————————————卸载———————————————————————————————————————
卸载 卸载Jellyfin全家桶 -> 6 8 3 4
卸载 Resilio-Sync(单独) -> 6 8 2 2 3
———————————————————————————————————————其他———————————————————————————————————————
创建/删除 定时同步更新数据(小雅alist启动时拉取的数据)-> 6 8 1 1
```
## 相关地址
- [https://github.com/xiaoyaDev/xiaoya-alist](https://github.com/xiaoyaDev/xiaoya-alist)
- [https://hub.docker.com/r/ddsderek/xiaoya-emd](https://hub.docker.com/r/ddsderek/xiaoya-emd)
- [https://hub.docker.com/r/ddsderek/xiaoya-proxy](https://hub.docker.com/r/ddsderek/xiaoya-proxy)
- [https://hub.docker.com/r/ddsderek/xiaoya-cron](https://hub.docker.com/r/ddsderek/xiaoya-cron)
- [https://hub.docker.com/r/ddsderek/xiaoya-glue](https://hub.docker.com/r/ddsderek/xiaoya-glue)
- [https://hub.docker.com/r/ddsderek/xiaoya-115cleaner](https://hub.docker.com/r/ddsderek/xiaoya-115cleaner)
- [https://gitee.com/ddsrem/xiaoya-alist-base](https://gitee.com/ddsrem/xiaoya-alist-base)
- 小雅官方 [Telegram](https://t.me/xiaoyaliu00) 交流群
## 通用兼容性测试报告
> [!NOTE]
> ✅代表测试通过且兼容;❌代表不兼容;🚧代表未经过充分测试兼容性不确定!
| 软件名称 | x86-64 \| amd64 | arm64 \| arm64v8 | armhf \| armv7 |
| :------------------------------: | :--------------: | :---------------: | :-------------: |
| 小雅Alist | ✅ | ✅ | ✅ |
| 小雅Emby全家桶 | ✅ | ✅ | ❌ |
| 小雅Jellyfin全家桶 | ✅ | ✅ | ❌ |
| 小雅助手(xiaoyahelper) | ✅ | ✅ | ✅ |
| 小雅Alist-TVBox | ✅ | ✅ | ❌ |
| Onelist | ✅ | ✅ | ✅ |
| 小雅元数据爬虫(xiaoya-emd) | ✅ | ✅ | ✅ |
| 小雅元数据爬虫(Web 版本) | ✅ | ✅ | ✅ |
| 小雅Cron容器(xiaoya-cron) | ✅ | ✅ | ✅ |
| 小雅代理容器(xiaoya-proxy) | ✅ | ✅ | ✅ |
| 115清理助手(xiaoya-115cleaner) | ✅ | ✅ | ✅ |
| xiaoya-glue(官方 python) | ✅ | ✅ | ❌ |
| xiaoya-glue(官方 latest) | ✅ | ✅ | ✅ |
| xiaoya-glue(DDSRem python) | ✅ | ✅ | ❌ |
| xiaoya-glue(DDSRem aliyuntvtoken_connector) | ✅ | ✅ | ✅ |
| 系统名称 | all_in_one.sh | emby_config_editor.sh | xiaoya_notify.sh(已弃用) |
| :-------------: | :-----: | :-------------------: | :-------------: |
| CentOS 7.9 | ✅ | ✅ | ✅ |
| CentOS 8.4 | ✅ | ✅ | ✅ |
| CentOS 8 Stream | ✅ | ✅ | ✅ |
| CentOS 9 Stream | ✅ | ✅ | ✅ |
| Debian 10.3 | ✅ | ✅ | ✅ |
| Debian 11.3 | ✅ | ✅ | ✅ |
| Debian 12.0 | ✅ | ✅ | ✅ |
| Ubuntu 18.04 | ✅ | ✅ | ✅ |
| Ubuntu 20.04 | ✅ | ✅ | ✅ |
| Ubuntu 22.04 | ✅ | ✅ | ✅ |
| Ubuntu 22.10 | ✅ | ✅ | ✅ |
| Ubuntu 23.04 | ✅ | ✅ | ✅ |
| Fedora 31 | ✅ | ✅ | ✅ |
| Fedora 32 | ✅ | ✅ | ✅ |
| Fedora 36-38 | ✅ | ✅ | ✅ |
| Fedora 40 | ✅ | ✅ | ✅ |
| Fedora 41 | ✅ | ✅ | ✅ |
| Fedora 42 | ✅ | ✅ | ✅ |
| AlmaLinux 9 | ✅ | ✅ | ✅ |
| RockyLinux 8.6 | ✅ | ✅ | ✅ |
| Arch Linux | ✅ | ✅ | ✅ |
| openSUSE 15.4 | ✅ | ✅ | ✅ |
| FreeBSD | ✅ | ✅ | ✅ |
| EulerOS | ✅ | ✅ | ✅ |
| Amazon Linux | ✅ | ✅ | ✅ |
| Alpine | ✅ | ✅ | ✅ |
| MacOS | ✅ | ✅ | 🚧 |
| UnRaid | ✅ | ✅ | ✅ |
| OpenMediaVault | ✅ | ✅ | ✅ |
| QNAP(威联通) | ✅ | ✅ | ✅ |
| OpenWRT | ✅ | ✅ | ✅ |
| Synology(群晖) | ✅ | ✅ | ✅ |
| TrueNAS CORE | 🚧 | 🚧 | 🚧 |
| TrueNAS SCALE | 🚧 | 🚧 | 🚧 |
| UGOS(绿联云) | ✅ | ✅ | ✅ |
| UGOS Pro(绿联云 Pro) | ✅ | ✅ | ✅ |
| LibreELEC | ❌ | ❌ | ❌ |
| Windows WSL Docker | 🚧 | 🚧 | ❌ |
| ZSpace(极空间) | 🚧 | 🚧 | 🚧 |
| fnOS (飞牛私有云) | ✅ | ✅ | ✅ |
## Star History
[![Star History Chart](https://api.star-history.com/svg?repos=xiaoyaDev/xiaoya-alist&type=Date)](https://star-history.com/#xiaoyaDev/xiaoya-alist)
## 小雅周边工具集合
- [AI老G 脚本推荐](https://b23.tv/3Zo0IvD)
- 小雅全家桶安装脚本(支持AI老G版小雅Alist安装,Jellyfin安装,快速Emby安装):
```shell
bash <(curl -sSLf https://xy.ggbond.org/xy/xy_install.sh)
```
- TG 群组:https://t.me/ailg666
- [Xiaoya-convert](https://github.com/ypq123456789/xiaoya-convert): 自动批量将阿里云盘分享链接转换为小雅`alishare_list.txt`中的格式
- [Xiaoyahelper](https://github.com/xiaoyaDev/xiaoyahelper): 一劳永逸的小雅转存清理工具
- [Alist-TVBox](https://hub.docker.com/r/haroldli/alist-tvbox): 一个基于`AList`和`xiaoya`的`TVBox`管理工具
- [`strm`文件生成](https://xiaoyaliu.notion.site/strm-2c8d136ceb37445fb6c0222eafb966ce): 小雅官方提供的一键生成`strm`文件脚本
- [monlor/docker-xiaoya](https://github.com/monlor/docker-xiaoya): Docker Compose 方式一键部署小雅全家桶
- [xiaoya-sync](https://github.com/xiaoyaDev/xiaoya-sync): Java 编写的小雅元数据爬虫
- [sjtuross/StrmAssistant](https://github.com/sjtuross/StrmAssistant): Strm Assistant for Emby
- [suixing8/xiaoya-alist-search](https://github.com/suixing8/xiaoya-alist-search): 不安装Emby的情况下,在iOS Fileball上使用全局搜索和直接观看
## 感谢
- [xiaoyaLiu](http://alist.xiaoya.pro/)
- [heiheigui](https://xiaoyahelper.zengge99.eu.org/aliyun_clear.sh)
- [alist-tvbox](https://github.com/power721/alist-tvbox)
- [Auto_Symlink](https://github.com/shenxianmq/Auto_Symlink)
- [Portainer](https://github.com/portainer/portainer)
- [AI老G](https://space.bilibili.com/252166818)
- [monlor](https://link.monlor.com)
- [Rik](https://github.com/Rik-F5)
<a href="https://github.com/xiaoyaDev/xiaoya-alist/graphs/contributors"><img src="https://contrib.rocks/image?repo=xiaoyaDev/xiaoya-alist"></a>
## 捐赠
- [捐赠项目作者DDSRem](https://raw.githubusercontent.com/xiaoyaDev/xiaoya-alist/master/assets/appreciate-ddsrem.png)
- [捐赠小雅](https://raw.githubusercontent.com/xiaoyaDev/xiaoya-alist/master/assets/appreciate-xiaoya.png)
- [捐赠AI老G](https://raw.githubusercontent.com/xiaoyaDev/xiaoya-alist/master/assets/appreciate-ailaog.png)
## 许可证
此项目根据 GNU General Public License v3.0 许可证进行许可,详见[`LICENSE`](LICENSE) 文件。
### 附加条款
- 请勿将 小雅系列软件 用于商业用途。
- 请勿将 小雅系列软件 用于任何违反法律法规的行为。
- 本仓库所有脚本均基于官方脚本制作,使用请自行承担数据损失但不限于此的风险。
- 本仓库所有脚本仅供学习交流,使用本仓库脚本进行违法操作产生的法律责任由操作者自行承担。
### 免责声明
使用此项目则意味着你接受以上规定和 GNU General Public License v3.0 许可证。
+227
View File
@@ -0,0 +1,227 @@
---
aliases: README
tags:
cssclass:
source:
obsidianUIMode: preview
progress: 正在进行
title: README
updated: 2025-09-22T13:27
created: 2022-09-01 09:56
---
![](https://user-images.githubusercontent.com/42957010/184872220-f9b52079-8695-46a7-b517-0588426aa7b5.jpg)
感谢@代码7 的视频
<video autoplay="autoplay" loop="loop" id="video" x-webkit-airplay="true" webkit-playsinline="true" muted=""><source src="https://user-images.githubusercontent.com/72023275/198887920-575d0735-2433-41ff-8960-3c7bacbdf532.mp4" type="video/mp4"></video>
## Compatible with Obsidian 1.0 !!
## 💡引言
This Vault contains the basic functions of Obsidian and has built-in common Obsidian plugins.
Notice:You need to open this vault with [Obsidian](https://obsidian.md/)
Recommend downloading the Lite version of the example vault to delete a large number of unnecessary plug-ins, download link
https://github.com/cumany/Blue-topaz-examples/releases/tag/20220816-lite
---
注意:本示例库包含大量插件目前有七十多个,很多插件都是辅助类插件,可以根据需要删除或者关闭,为了方便初学者,特推出一个简化版示例库删减了大量不必要的插件下载链接
[Release 20221208 lite 精简版 · cumany/Blue-topaz-examples (github.com)](https://github.com/cumany/Blue-topaz-examples/releases/tag/20221208-lite)
本 [Examples库](https://github.com/cumany/Blue-topaz-examples) 由 Cuman 建立,Tips 教程由 [BT主题](https://github.com/whyt-byte/Blue-Topaz_Obsidian-css) 作者 3F 撰写。
本库是一个包含 Obsidian 基本功能的入门库,并内置了 Obsidian 的常用插件。
需要用 [Obsidian](https://obsidian.md/) 软件打开本库即可。
特别感谢@Johnny @Lillianwho @lavi @成雙酱 @锋华 提供的教程和创作思路。
如果有问题或者建议 请加入 Topaz 社区 [Topaz QQ群](https://jq.qq.com/?_wv=1027&k=TWGhXs40) [Obsidian频道](https://qun.qq.com/qqweb/qunpro/share?_wv=3&_wwv=128&inviteCode=zHpby&from=246610&biz=ka)
## 🎞视频教程
<https://space.bilibili.com/1970226/channel/series>
## 👉后续更新 请关注
- [Examples库](https://github.com/cumany/Blue-topaz-examples)
- [Blue topaz 主题用法示例 - 飞书文档 (feishu.cn)](https://kknwfe6755.feishu.cn/docs/doccn67RYLVN4IQZiJTwviIdnog)
另外推荐鸟姐的 Homepage 也是很棒的风格
[Rainbell129/Obsidian-Homepage: A dashboard for your obsidian vault. (github.com)](https://github.com/Rainbell129/Obsidian-Homepage)
## 🚩更新日志
[[Changlog]]
[Changlog.md (github.com)](https://github.com/cumany/Blue-topaz-examples/blob/main/Changlog.md)
## 效果图
总览图
![image](https://user-images.githubusercontent.com/42957010/165482190-91dc0585-9e75-406c-a7a3-1121c1fc88f7.png)
![](https://s1.ax1x.com/2022/05/18/OIHZwQ.jpg)
笔记模板
![](https://s1.ax1x.com/2022/05/18/OIHYTJ.png)
卡片视图
![image](https://user-images.githubusercontent.com/42957010/165482534-f0ef2dd2-cf3a-4347-b141-e8bbae63566d.png)
![](https://s1.ax1x.com/2022/05/18/OIHbkj.png)
读书笔记
![](https://s1.ax1x.com/2022/05/18/OIHxXT.png)
## 内置的插件
斜体插件为可选插件,基本是辅助类,不影响功能性使用。
除去辅助类插件,剩余基本十几个插件就满足 Ob 个性化使用的同时还能体验不同的功能。
| 插件名称 | 解释 |
|:--------------------------------------- |:--------------------------------------------------------------- |
| *ZH 增强编辑* | 提供大量格式排版相关快捷操作 |
| workspaces-plus | 工作区切换 |
| templater-obsidian | Ob 模板插件 |
| *tag-wrangler* | (可选) 标签修改 |
| *Advanced Tables* | (可选) 表格辅助 |
| *remember-cursor-position* | (可选) 记住光标位置 |
| recent-files-obsidian | (可选) 最近文件列表 |
| quickadd | 快速添加命令和动作 |
| *plugin-changelogs* | (可选) 插件历史记录 |
| *obsidian-theme-design-utilities* | (可选) 主题调试插件 |
| obsidian-style-settings | 主题设置插件,必备 |
| *obsidian-shellcommands* | (可选) 系统命令执行插件 |
| obsidian-outliner | 类似幕布大纲操作插件 |
| obsidian-kanban | 看板 |
| *obsidian-frontmatter-tag-suggest* | (可选)yaml 输入标签弹出提示 |
| *obsidian-collapse-all-plugin* | (可选) 一键折叠文件夹 |
| ~~obsidian-codemirror-options~~ | v0.13.14 之前的所见即所得插件, v0.13.14 之后的 ob 版本直接关闭即可 |
| obsidian-checklist-plugin | 任务列表插件 |
| obsidian-banners | 主页显示头图 |
| obsidian-admonition | 文本框插件 |
| *hotkey-helper* | (可选) 热键提示插件 |
| ~~homepage~~ | 打开 ob 显示主页插件,非必须已禁用 |
| dataview | 数据查询插件 |
| *cMenu 魔改版 by cuman* | (可选) 快捷工具栏,需要依赖 zh 增强编辑插件 |
| ~~cm-editor-syntax-highlight-obsidian~~ | 语法高亮插件,不兼容 v0.13.14 之后的 ob 版本直接关闭即可 |
| calendar | 日历插件 |
| buttons | 按钮插件 |
| *Obsidian Icon Folder* | (可选) 文件自定义图标插件 |
| obsidian-view-mode-by-frontmatter | 通过 yaml 设置文档默认打开是预览还是编辑模式 |
| *obsidian-floating-toc-plugin* | (可选) 编辑模式浮动大纲 |
| obsidian-memos by bon | 流水账的方式记录日记,依赖日记插件。 |
| *bartender* | (可选) 隐藏边栏图标和状态栏图标 |
| *sortable* | (可选) 表格列排序插件 |
| *markdown Pretiffier* | (可选)md 格式辅助插件可以自动生成更新日期 |
| *Search on Internet* | (可选)ob 中快捷进行网络搜索 |
| booknote | (可选)pdf 查看和标注插件 |
| *cm-chs-patch* | (可选)中文分词插件 |
| *obsidian-core-search-assistant-plugin* | (可选)增强搜索插件,搜索结果卡片显示 |
| *various-complements* | (可选)自动补全插件 |
| obsidian-linter | (可选)自动更新 yaml 日期插件 |
| table-editor-obsidian | (可选)表格悬浮编辑插件 |
| obsidian-regex-replace | (可选)支持正则表达式的查找替换插件 |
| obsidian-version-history-diff | (可选)文档修改历史恢复插件 (ctrl+r) |
| waypoint | (可选)文件夹 moc 生成插件 |
| obsidian-dynamic-highlights | (可选)实时预览模式下,按高亮指定文档比如日记中的时间 |
| obsidian-hover-editor | 悬浮插件,让窗口直接悬浮 |
| Obsidian-Agtable | (可选)普通表格转为可视化编辑表格 |
## 主题内置的 cssclass 样式表
```expander
path: 77-Example usage:
^|文件名称|cssclass|用法|
^|---|---| ---|
|[[$filename]]|$frontmatter:cssclass|$frontmatter:usage|
```
|文件名称|cssclass|用法|
|---|---| ---|
|[[电影观看清单-状态控制(dvjs)]]|cards|对dataview表格渲染成卡片视图|
|[[电影观看清单(dv)]]|cards|对dataview表格渲染成卡片视图|
|[[多彩高亮(三种语法)]]|colorful-highlight|实时预览模式下正确显示多彩高亮|
|[[各类列表和彩虹大纲线]]|noscroll|隐藏当前页面滚动条|
|[[卡片视图 展示笔记]]|zettelkasten|把dv表格渲染成卡片样式|
|[[全宽显示-表格测试]]|fullwidth|缩减栏宽开启下,控制页面全宽显示|
|[[首行缩进--以2022政府工作报告为例]]|indent|实现单篇笔记首行缩进效果|
|[[四象限表格]]|matrix|四象限表格样式|
|[[图书阅读清单-状态控制(dvjs)]]|cards|对dataview表格渲染成卡片视图|
|[[图书阅读清单(dv)]]|cards|对dataview表格渲染成卡片视图|
|[[涂黑和挖空效果(三种语法)]]|cloze|实时预览模式下正确显示涂黑和挖空效果|
|[[伪看板-yaml声明]]|kanban|伪看板的样式,无序列表四分栏|
|[[无序列表分栏]]|gridlist|无序列表分两栏排布,可以配合伪看板(kanban)一起使用|
|[[预览隐藏frontmatter]]|noyaml|预览状态不显示frontmatter区域|
|[[Callout环绕布局、缩进效果示例]]|fullwidth|callout实现文章环绕,全文缩进效果|
|[[code-wrap【代码块自动换行】]]|code-wrap|代码块自动换行|
|[[example database]]|||
|[[Image-grid【图片自适应】]]|img-grid|图片自适应分布|
|[[inline-list【行内列表】]]|inline-list|图片和列表混排|
<-->
## 主题内置的 ad 样式表
ad 样式使用方法参考
[[分栏效果示例#前置条件]]
[[分栏效果示例#AD样式效果]]
| Admonition 类型 | 解释 | 使用 |
| ------------ | -------------- | --------- |
| blank | 全透明框 | ad-blank |
| def | definition 定义 | ad-def |
| thm | theorem 定理 | ad-thm |
| lem | lemma 引理 | ad-lem |
| cor | corollary 推论 | ad-cor |
| pro | proposition 命题 | ad-pro |
| hibox | 自动隐藏框 | ad-hibox |
| col2 | 内容分左右两栏 | ad-col2 |
| kanban | 伪看板 无序列表并列 | ad-kanban |
| flex | 自适应元素分栏 | ad-flex |
## Javascript 作用
> 88-Template\script
| 名称 | 功能 | 调用 js 的功能 |
| ------------------ | ------------------------------ | ------------------- |
| bookfromdouban.js | 根据 url 从豆瓣获取图书数据 | Quickadd- 宏 - 豆瓣读书 |
| changeSticky.js | 快捷修改 home.md 中的四个便签内容 | Quickadd- 宏 - 添加首页便签 |
| colorclock.js | 彩色时钟 js | 已通过 react 组件实现,此 js 已弃用 |
| fetchhomepage.js | 获取主页中的联网数据 (OB 启动后加载) | quickadd- 宏 -Home 工作区 |
| movies.js | 从 IMDB 获取电影数据 | quickadd- 宏 - 电影卡片 |
| notice.js | 生成自定义边栏提示 | quickadd- 宏 - 生成 notice |
| refreshhomepage.js | 重载主页数据,重新获取联网数据 | quickadd- 宏 - 重新获取主页数据 |
| getrandomImage.js | 随机获取 99-Attachment\banner 文件夹的图片 | tp- 日记模板获取 banner |
| getweather.js | 获取天气数据 | tp- 日记模板获取天气 |
## ❓ 常见问题
1. 如何获取指定地区的天气?
- 侧边栏天气默认根据 ip 地址自动获取,修改 [[常用工具]] 并手动指定 `https://i.tianqi.com/?c=code&id=34&bdc=%23&icon=4&site=14&py=chongqing` chongqing 改为你想要的城市拼音即可。
- 主页天气 也可以手动指定地区,quickadd 宏 -home 工作区 -- 点击 config-fetchhomepage 点击齿轮图标 即可设置天气.
2. 如何更换字体?
示例库默认配置的主字体为 [[LXGWWenKai-Light.ttf]] 代码块字体为 [[JetBrainsMono-Regular.ttf]] 可以自行安装,即可自动识别。
如果要安装其他字体,打开 style settings 设置,2.2.1 字体设置,主字体里填写 **字体名称** 即可。注意如果字体名称有空格需要用单引号括起来。
字体需要安装到系统里才会成功调用,比如 win 系统安装后显示的 **字体名称** 才是真正的字体名称。
![[Pasted image 20220119151051.png]] ^d0e999
3. 如何更换 Ob 背景图?
打开 style settings 设置,1.2.1 工作页面背景,开启背景,并在 custom theme light(亮色主题使用) 或者 custom theme dark(暗色主题使用) 里设置壁纸路径.壁纸路径需要使用类似格式 url("app://local/XXXXX) 设置本地图片。
比如 windows 图片路径置
url(app://local/D:/Documents/XXXX.jpg")
mac 系统图片路径设置 url("app://local/Users/XXXX .jpg")
4. 工作区页面背景跟笔记背景的区别?
工作区页面背景是指整个 OB 界面背景,笔记背景仅仅是当前 md 文档的背景。两者不冲突可以同时设置,当然这样背景也就叠加一起了。如果只需要整个 OB 是一个背景图,笔记背景关闭即可。
5. 主页的歌曲和每日一言如何更新?
点击主页的 topaz 图片 或者侧边栏的重载主页 都可以重新获取最新的歌曲和一言。重新获取后如何没有显示出来,点击刷新主页即可。
![[Pasted image 20220119152758.png]]
6. 备忘录 Memos 无法启动打开?
开启核心插件日记,并指定日记文件夹位置。
7. 主页加载部分数据没有显示全?
如果时钟不动或者主页没有显示全。手动点一下刷新主页即可。
8. 带按钮的常用工具侧边栏如何实现?
其实就是 `88-template/常用工具` 笔记文档,打开后拖动文档标题前的图标到侧边栏即可。
9. 示例库目前有五十多个插件,实在太多了,想保持示例库主要功能的话需要几个插件
示例库真正需要的核心插件并不多,大部分都是为了 Ob 使用更方便的辅助类插件,可以根据自己需要开启。
如果想体验最精简版本的示例库很简单。
按图修改 [[FastStart-StartupScript]] ![[Pasted image 20220315145116.png|500]] 即可启动最低示例库运行插件配置。
启动后启动 ob 只需要 100ms
![[Pasted image 20220315144725.png|300]]
10. 侧边栏悬浮 memos 无法打开有错误提示?
需要先 `ctrl+p` ==>`打开其他库`,然后选择示例库“20-diary”文件夹,打开一次之后,这个悬浮按钮就自动生效。详情看 [[Obsidian 库中库玩法#实现]]
11. 为什么在 style setting 下切换配色没什么效果?
![[Pasted image 20220429154332.png]]
注意 2.1 里面的颜色设置 是不是有自定义颜色。这里的自定义颜色设置优先级比较高,建议把里面的颜色设置都恢复成默认就可以了。
12. 如何取消开启 ob 自动加载主页,我想打开 ob 出现上次关闭时的笔记?
打开 quickadd 设置,宏管理 关闭 home 工作区的 启动加载选项。
![[Pasted image 20220523110336.png]]
13. 如何移植动画版天气到自己的主页?并获取指定城市天气?
直接复制 " 文字版天气加图标 " 注释之间的内容,并 copy"88-Template/script/dv_weatherSvg.js" 启用【天气】weather.css 样式片段就移植成功了。设置指定地区天气,需要在 quickadd 宏 home 工作区中如图设置即可。![[Pasted image 20220531101243.png|400]]
14. 如何移植动画猫到自己的主页中?
跟多彩时钟一样,动画猫也是 react 组件生成的。需要首先安装 react_component 插件,并 copy`\88-Template\ReactJS\react_cat.md` 这样动画猫代码就生效了。
## 捐赠
如果你觉得不错,这个示例库对你使用 ob 有帮助,可以支持我一下。
![image|350](https://ghproxy.com/https://raw.githubusercontent.com/cumany/cumany/main/pic/202209192228895.png)
+1
View File
@@ -0,0 +1 @@
{"layout":"logicalStructure","root":{"data":{"text":"根节点","expand":true,"uid":"3cb9f800-5a74-4609-a8ff-c37a0beb0bd8","richText":true,"isActive":false},"children":[{"data":{"text":"二级节点","generalization":{"text":"概要","uid":"cd2361f6-2cc4-4dc6-b336-57b46f8b33ed","richText":true,"expand":true,"isActive":false},"uid":"a7ae8e47-39fb-4370-ae20-d22f703e7065","richText":true,"expand":true,"isActive":false},"children":[{"data":{"text":"分支主题","uid":"ff04f5b8-f02b-4faf-b598-a5fb8f666b91","richText":true,"expand":true,"isActive":false},"children":[]},{"data":{"text":"分支主题","uid":"796eef36-18e2-41e2-96c6-25fcc2162d2d","richText":true,"expand":true,"isActive":false},"children":[]}]}],"smmVersion":"0.14.0-fix.1"},"theme":{"template":"classic4","config":{}},"view":{"transform":{"scaleX":1,"scaleY":1,"shear":0,"rotate":0,"translateX":0,"translateY":0,"originX":0,"originY":0,"a":1,"b":0,"c":0,"d":1,"e":0,"f":0},"state":{"scale":1,"x":0,"y":0,"sx":0,"sy":0}},"svgData":""}
File diff suppressed because one or more lines are too long
+1
View File
@@ -0,0 +1 @@
{"layout":"logicalStructure","root":{"data":{"text":"<p>服务器部署</p>","generalization":[],"expand":true,"uid":"d33f177e-b5d0-4c8e-a17b-c22b9bdc5aaa","richText":true,"isActive":false},"children":[{"data":{"text":"<p>TC9161</p>","generalization":[],"uid":"31cbd0ad-2d3c-4932-93c2-dfafde9b96f8","richText":true,"expand":true,"isActive":false},"children":[{"data":{"text":"<p>M1/Mini备份/手机备份</p>","generalization":[],"uid":"609f76e9-e9a3-4f9f-ba43-c0b45adfc345","richText":true,"expand":true,"isActive":false},"children":[]}]},{"data":{"text":"<p>DSM8466</p>","generalization":[],"uid":"8ee5fa7b-27b8-4e43-bdc6-b5df534536f2","richText":true,"expand":true,"isActive":false},"children":[{"data":{"text":"<p>Plex Server? 纪录片\nAList 移动端支持WebDav播放APP\nSRS4\nLanSky \nTaleBook kybook3 Calibre用于整理和维护 \nSynclogy Drive 6690\nownCloud Server 9119 \nHyper\nWordPress 个人博客\n\n以Alist为主线,支持网页和移动端,配合Jellyfin+kybook3</p>","generalization":[],"uid":"56f44c88-99c9-4cfa-ab4e-53793260ac23","richText":true,"expand":true,"isActive":false},"children":[{"data":{"text":"<p>内部磁盘:\n2*8T Raid1 \n日常资料同步:常用软件/个人文档\n电子书发布 TaleBook /data/books/imports\n用calibre整理、分类\n绿联磁盘盒/外接磁盘:PM\n8T+10T \n10T 日立盘 纪录片(暂时)\n8T 希捷 教育资料(中小学)\n 小苹果学习资料</p>","generalization":[],"uid":"b34a312f-d2a0-44bf-a912-c1e245b04d20","richText":true,"expand":true,"isActive":false},"children":[]}]}]},{"data":{"text":"<p>DSM9161</p>","generalization":[],"uid":"bf6e69d7-2af0-48fb-a683-eefc6505c8b9","richText":true,"expand":true,"isActive":false},"children":[{"data":{"text":"<p>Hyper 备份\n2*4T PM\n软件备份\n电子书备份\n</p>","generalization":[],"uid":"76129603-0820-4e1f-83ab-018f249f925b","richText":true,"expand":true,"isActive":false},"children":[{"data":{"text":"<p>奥睿磁盘盒/外接磁盘:2T+1T PM\n文档/程序备份\n照片/视频备份\n\n现有数据全部考入2.5寸归档\nWindows备份使用U盘制作</p>","generalization":[],"uid":"9bcee98b-fefc-4519-b549-706b5fc3098f","richText":true,"expand":true,"isActive":false},"children":[]}]}]},{"data":{"text":"<p>MacServer mini</p>","generalization":[],"uid":"02074990-9f9b-49fd-80d9-00d89e12d602","richText":true,"expand":true,"isActive":false},"children":[{"data":{"text":"<p>Plex Server 娱乐 电影\nGitea Git Server 3000\nAlist WebDAV 9909\nCalibre\n</p>","generalization":[],"uid":"c915a4de-3f8c-409a-8520-eff29307a028","richText":true,"expand":true,"isActive":false},"children":[{"data":{"text":"<p>外接磁盘:\n5*8T Raid5 CM292 APFS\n32T容量 内容发布主存储\n教育资料(非中小学教育) myMedia\n教学资料 myMedia\n视频/音乐 myMedia\n电子书 myBooks Calibre-XXXX@2023书库发布(个人) myMedia 有声书\n软件仓库 同名 \n个人空间(汇集:照片+视频+文档)\n个人工作室 同名 源代码/开发工具/特殊工具/技术文档/程序\n\n其他:知识库/笔记本/KeePass等</p>","generalization":[],"uid":"2d0f0d9f-5497-45dc-855f-6c6c986a419b","richText":true,"expand":true,"isActive":false},"children":[]}]}]}],"smmVersion":"0.14.0-fix.1"},"theme":{"template":"classic4","config":{}},"view":{"transform":{"scaleX":1,"scaleY":1,"shear":0,"rotate":0,"translateX":0,"translateY":0,"originX":0,"originY":0,"a":1,"b":0,"c":0,"d":1,"e":0,"f":0},"state":{"scale":1,"x":0,"y":0,"sx":0,"sy":0}},"svgData":""}
File diff suppressed because one or more lines are too long
@@ -0,0 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>URL</key>
<string>https://discourse.devontechnologies.com/t/switching-sync-method-to-bonjour/68950/4</string>
</dict>
</plist>
BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 694 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.6 KiB

+29
View File
@@ -0,0 +1,29 @@
/* AGPLv3 License
Floating Status Bar
Author: AnubisNekhet
Note: If you decide to implement it in your theme or redistribute it, please keep this comment (Especially for *certain* individuals who may try to rebrand it as their own :))
Support me: https://buymeacoffee.com/AnubisNekhet
*/
body {
--status-bar-position: absolute;
--status-bar-radius: var(--radius-m);
}
body .status-bar {
transform: translateX(calc(100% + 5px));
transition: transform 300ms 150ms;
bottom: 5px;
right: 5px;
}
body .status-bar::before {
width: 100%;
min-height: 100%;
content: " ";
position: absolute;
left: 0;
bottom: 0;
transform: translateX(-100%);
}
body .status-bar:hover {
transform: none;
transition: transform 300ms 150ms;
}
+169
View File
@@ -0,0 +1,169 @@
/*
* @Author: Lanke
* 仿github版Obsidian Callout样式
*/
/* 基础callout样式 */
.callout {
border: none;
box-shadow: inset 0 0 0 2px rgba(var(--callout-color), 0.25), 0px 0.5px 1px 0.5px rgba(0, 0, 0, 0.1) !important;
padding: 0.5rem 1rem;
border-left: 0.25em solid var(--rc-color-light, #888);
margin-bottom: 1rem;
width: 100%;
}
.dark .callout {
border-left-color: var(--rc-color-dark, #888);
}
.callout .callout-title {
padding: 6px 8px 6px 6px !important;
background-color: transparent;
display: flex;
line-height: 1 !important;
align-items: center !important;
gap: 8px;
color: var(--rc-color-light, #888);
font-weight: 500;
cursor: pointer;
}
.dark .callout-title {
color: var(--rc-color-dark, #888);
}
/* 自定义标题字体 */
.callout-title,
.callout .callout-title,
.callout-title-inner {
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif !important;
font-weight: 600 !important;
}
.callout-title-inner,
.callout-title-content {
font-family: inherit !important;
font-weight: inherit !important;
}
/* 颜色定义 */
[data-callout='note'] {
--rc-color-light: var(--callout-note-color-light, #0969da);
--rc-color-dark: var(--callout-note-color-dark, #2f81f7);
}
[data-callout='tip'] {
--rc-color-light: var(--callout-tip-color-light, #1a7f37);
--rc-color-dark: var(--callout-tip-color-dark, #3fb950);
}
[data-callout='important'] {
--rc-color-light: var(--callout-important-color-light, #8250df);
--rc-color-dark: var(--callout-important-color-dark, #a371f7);
}
[data-callout='warning'] {
--rc-color-light: var(--callout-warning-color-light, #9a6700);
--rc-color-dark: var(--callout-warning-color-dark, #d29922);
}
[data-callout='caution'] {
--rc-color-light: var(--callout-caution-color-light, #d1242f);
--rc-color-dark: var(--callout-caution-color-dark, #d1242f);
}
/* 隐藏所有默认图标 */
.callout .callout-icon svg {
display: none !important;
}
.callout .callout-icon {
display: flex !important;
align-items: center !important;
justify-content: center !important;
width: 24px !important;
height: 24px !important;
min-width: 24px !important;
min-height: 24px !important;
}
.callout .callout-icon::before {
content: "" !important;
display: block !important;
width: 20px !important;
height: 20px !important;
background-color: currentColor !important;
-webkit-mask-size: contain !important;
mask-size: contain !important;
-webkit-mask-position: center !important;
mask-position: center !important;
-webkit-mask-repeat: no-repeat !important;
mask-repeat: no-repeat !important;
}
/* Note 图标*/
.callout[data-callout="note"] .callout-icon::before {
-webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z'/%3E%3C/svg%3E");
mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z'/%3E%3C/svg%3E");
}
/* Tip 图标 */
.callout[data-callout="tip"] .callout-icon::before {
-webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M8 1.5c-2.363 0-4 1.69-4 3.75 0 .984.424 1.625.984 2.304l.214.253c.223.264.47.556.673.848.284.411.537.896.621 1.49a.75.75 0 0 1-1.484.211c-.04-.282-.163-.547-.37-.847a8.456 8.456 0 0 0-.542-.68c-.084-.1-.173-.205-.268-.32C3.201 7.75 2.5 6.766 2.5 5.25 2.5 2.31 4.863 0 8 0s5.5 2.31 5.5 5.25c0 1.516-.701 2.5-1.328 3.259-.095.115-.184.22-.268.319-.207.245-.383.453-.541.681-.208.3-.33.565-.37.847a.751.751 0 0 1-1.485-.212c.084-.593.337-1.078.621-1.489.203-.292.45-.584.673-.848.075-.088.147-.173.213-.253.561-.679.985-1.32.985-2.304 0-2.06-1.637-3.75-4-3.75ZM5.75 12h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1 0-1.5ZM6 15.25a.75.75 0 0 1 .75-.75h2.5a.75.75 0 0 1 0 1.5h-2.5a.75.75 0 0 1-.75-.75Z'/%3E%3C/svg%3E");
mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M8 1.5c-2.363 0-4 1.69-4 3.75 0 .984.424 1.625.984 2.304l.214.253c.223.264.47.556.673.848.284.411.537.896.621 1.49a.75.75 0 0 1-1.484.211c-.04-.282-.163-.547-.37-.847a8.456 8.456 0 0 0-.542-.68c-.084-.1-.173-.205-.268-.32C3.201 7.75 2.5 6.766 2.5 5.25 2.5 2.31 4.863 0 8 0s5.5 2.31 5.5 5.25c0 1.516-.701 2.5-1.328 3.259-.095.115-.184.22-.268.319-.207.245-.383.453-.541.681-.208.3-.33.565-.37.847a.751.751 0 0 1-1.485-.212c.084-.593.337-1.078.621-1.489.203-.292.45-.584.673-.848.075-.088.147-.173.213-.253.561-.679.985-1.32.985-2.304 0-2.06-1.637-3.75-4-3.75ZM5.75 12h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1 0-1.5ZM6 15.25a.75.75 0 0 1 .75-.75h2.5a.75.75 0 0 1 0 1.5h-2.5a.75.75 0 0 1-.75-.75Z'/%3E%3C/svg%3E");
}
/* Important */
.callout[data-callout="important"] .callout-icon::before {
-webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M0 1.75C0 .784.784 0 1.75 0h12.5C15.216 0 16 .784 16 1.75v9.5A1.75 1.75 0 0 1 14.25 13H8.06l-2.573 2.573A1.458 1.458 0 0 1 3 14.543V13H1.75A1.75 1.75 0 0 1 0 11.25Zm1.75-.25a.25.25 0 0 0-.25.25v9.5c0 .138.112.25.25.25h2a.75.75 0 0 1 .75.75v2.19l2.72-2.72a.749.749 0 0 1 .53-.22h6.5a.25.25 0 0 0 .25-.25v-9.5a.25.25 0 0 0-.25-.25Zm7 2.25v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 9a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z'/%3E%3C/svg%3E");
mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M0 1.75C0 .784.784 0 1.75 0h12.5C15.216 0 16 .784 16 1.75v9.5A1.75 1.75 0 0 1 14.25 13H8.06l-2.573 2.573A1.458 1.458 0 0 1 3 14.543V13H1.75A1.75 1.75 0 0 1 0 11.25Zm1.75-.25a.25.25 0 0 0-.25.25v9.5c0 .138.112.25.25.25h2a.75.75 0 0 1 .75.75v2.19l2.72-2.72a.749.749 0 0 1 .53-.22h6.5a.25.25 0 0 0 .25-.25v-9.5a.25.25 0 0 0-.25-.25Zm7 2.25v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 9a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z'/%3E%3C/svg%3E");
}
/* Warning */
.callout[data-callout="warning"] .callout-icon::before {
-webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z'/%3E%3C/svg%3E");
mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M6.457 1.047c.659-1.234 2.427-1.234 3.086 0l6.082 11.378A1.75 1.75 0 0 1 14.082 15H1.918a1.75 1.75 0 0 1-1.543-2.575Zm1.763.707a.25.25 0 0 0-.44 0L1.698 13.132a.25.25 0 0 0 .22.368h12.164a.25.25 0 0 0 .22-.368Zm.53 3.996v2.5a.75.75 0 0 1-1.5 0v-2.5a.75.75 0 0 1 1.5 0ZM9 11a1 1 0 1 1-2 0 1 1 0 0 1 2 0Z'/%3E%3C/svg%3E");
}
/* Caution */
.callout[data-callout="caution"] .callout-icon::before {
-webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M4.47.22A.749.749 0 0 1 5 0h6c.199 0 .389.079.53.22l4.25 4.25c.141.14.22.331.22.53v6a.749.749 0 0 1-.22.53l-4.25 4.25A.749.749 0 0 1 11 16H5a.749.749 0 0 1-.53-.22L.22 11.53A.749.749 0 0 1 0 11V5c0-.199.079-.389.22-.53Zm.84 1.28L1.5 5.31v5.38l3.81 3.81h5.38l3.81-3.81V5.31L10.69 1.5ZM8 4a.75.75 0 0 1 .75.75v3.5a.75.75 0 0 1-1.5 0v-3.5A.75.75 0 0 1 8 4Zm0 8a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z'/%3E%3C/svg%3E");
mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M4.47.22A.749.749 0 0 1 5 0h6c.199 0 .389.079.53.22l4.25 4.25c.141.14.22.331.22.53v6a.749.749 0 0 1-.22.53l-4.25 4.25A.749.749 0 0 1 11 16H5a.749.749 0 0 1-.53-.22L.22 11.53A.749.749 0 0 1 0 11V5c0-.199.079-.389.22-.53Zm.84 1.28L1.5 5.31v5.38l3.81 3.81h5.38l3.81-3.81V5.31L10.69 1.5ZM8 4a.75.75 0 0 1 .75.75v3.5a.75.75 0 0 1-1.5 0v-3.5A.75.75 0 0 1 8 4Zm0 8a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z'/%3E%3C/svg%3E");
}
/* 折叠图标样式 */
.callout[data-collapsible='true'] .callout-title {
cursor: pointer;
}
.callout[data-collapsible='true'] .callout-fold-icon {
display: flex;
align-items: center;
padding-inline-end: 8px;
}
.callout[data-collapsible='true'] > .callout-title .callout-fold-icon svg {
transform: rotate(-90deg);
transition: transform 100ms ease-in-out;
}
.callout[data-collapsible='true'][open] > .callout-title .callout-fold-icon svg {
transform: none;
}
.callout-fold-icon {
margin-left: -2px;
}
/* 内容区域样式 */
.callout-content > :first-child {
margin-top: 1rem;
}
.callout-content > :last-child {
margin-bottom: 0;
}
.callout-title::-webkit-details-marker {
display: none;
}
File diff suppressed because one or more lines are too long
+27
View File
@@ -0,0 +1,27 @@
---
marp: true
size: 16:9
theme: am_purple
paginate: true
headingDivider:
- 2
- 3
footer: \ *Joy.AG* *标题就是测试* *日期*
created: 2025-09-09T07:00
updated: 2025-09-11T09:37
---
# 这是一个PPT演示模板
> 本PPT模板基于Marp
> Marp是一个基于Markdown的PPT生成工具
---
这是第二页
---
这是第三页
+10
View File
@@ -0,0 +1,10 @@
---
created: 2025-09-08T22:43
updated: 2025-09-09T19:23
---
- [marp-themes · GitHub Topics](https://github.com/topics/marp-themes)
- [matsubara0507/marp-themes: Theme for Marp Next (github.com)](https://github.com/matsubara0507/marp-themes)
- [kaisugi/marp-theme-academic: Academic Presentation Slides with Marp (github.com)](https://github.com/kaisugi/marp-theme-academic)
- [johannesdewit/marp-theme-universiteit-leiden: Unofficial Leiden University theme for producing easy slides with Marp || Officieus Universiteit Leiden thema om gemakkelijk presentaties te maken met Marp (github.com)](https://github.com/johannesdewit/marp-theme-universiteit-leiden)
-
Binary file not shown.

After

Width:  |  Height:  |  Size: 109 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 193 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

+18
View File
@@ -0,0 +1,18 @@
---
title: Getting Started
nav_order: 2
has_children: true
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Getting Started
- [Setup Vault](11.SetupVault.md)
- [Configuration](12.Configuration.md)
- [Marp Syntax](13.MarpSyntax.md)
- [First Deck](14.FirstDeck.md)
+20
View File
@@ -0,0 +1,20 @@
---
title: Setup Vault
parent: Getting Started
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Setup Vault
Obsidian is a powerful note-taking app that allows users to create and organize their notes and ideas in a highly customizable and intuitive interface. Setting up Obsidian for optimal use requires a few key steps to ensure that you can get the most out of the app's features and capabilities.
The first step in setting up Obsidian is to create a vault, which is essentially a container for all of your notes and files. This can be done by simply creating a new folder on your computer and selecting it as your vault location within the app's settings. Once your vault is set up, you can start creating notes and organizing them into folders and subfolders as needed.
Next, it's important to customize Obsidian's settings to fit your workflow and preferences. This includes adjusting things like the default font and theme, enabling or disabling various plugins, and configuring hotkeys and other shortcuts for quick access to frequently used features.
![Vault Settings](pictures/VaultSettings.gif)
- Relative path to files
- Not use Wikilinks
- Detect all file extension
+49
View File
@@ -0,0 +1,49 @@
---
title: Configuration
parent: Getting Started
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Configuration
![Settings](pictures/Settings.png)
## Chrome Path
Sets the custom path for Chrome or Chromium-based browser to export PDF, PPTX, and image. If it\'s empty, Marp will find out the installed Google Chrome / Chromium / Microsoft Edge.
## Theme Path
Local paths to additional [theme CSS](https://marpit.marp.app/theme-css) for Marp core and Marpit framework. The rule for paths is following Markdown: Styles.
## Export Path
Specifies the user-defined path for exporting PDF, PPTX, and images. If left empty, Marp will export them in the same folder as the note. It's important to note that the export path has no impact on HTML exports.
## Enable HTML
Enable all HTML elements in Marp Markdown. Please Attention when you enable!!!
## Math Typesettings
Controls math syntax and the default library for rendering math in Marp Core. A using library can override by math global directive in Markdown.
## HTML Export
**This is an EXPERIMENTAL feature**
Controls HTML library for eporting HTML File in Marp Cli. bespoke.js is experimental
## Sync Preview
**This is an EXPERIMENTAL feature**
Sync the slide preview with the editor cursor
## Markdown It Plugins
**This is an EXPERIMENTAL feature**
Enable the [Markdown It Plugins](30.Markdown-it-Plugins.md) (Mark, Containers, Kroki)
+33
View File
@@ -0,0 +1,33 @@
---
title: Marp Syntax
parent: Getting Started
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Marp Syntax
Here are some of the key elements of Marp's syntax, along with references to their official documentation:
- Markdown: Marp uses standard Markdown syntax for formatting text, including headings, lists, links, images, and more. For a comprehensive guide to Markdown syntax, see the official documentation: https://www.markdownguide.org/basic-syntax/
- Slide separators: To create a new slide in Marp, you simply insert three hyphens (---) between two lines of text. You can also use three equal signs (===) to create a separator between slides. For more information on slide separators, see: https://marpit.marp.app/markdown#slide-separators
- Code blocks: Marp supports syntax highlighting for code blocks, which can be useful for technical presentations. To create a code block, simply indent the text by four spaces, or use triple backticks (`) to enclose the code. For more information on code blocks, see: https://marpit.marp.app/markdown#code-blocks
- Themes: Marp comes with a range of built-in themes for styling your presentations. You can also create your own custom themes using CSS. To apply a theme to your presentation, simply add a theme directive to the first line of your Markdown file. For more information on themes, see: https://marpit.marp.app/theme-css
- Speaker notes: Marp allows you to add speaker notes to your presentation, which are visible only to the presenter. To create speaker notes, simply add text inside the square brackets ([ ]) following a slide separator. For more information on speaker notes, see: https://marpit.marp.app/markdown#speaker-notes
These are just a few examples of Marp's syntax. For more detailed information and examples, you can refer to Marp's official documentation: https://marpit.marp.app/
## Auto-scaling features
- **Fitting header**: Get bigger heading that fit onto the slide by # `<!--fit-->`.
- Auto-shrink the **code block**
- Auto-shrink **KaTeX block**
![Auto Scaling](pictures/AutoScale.gif)
[reference](https://github.com/marp-team/marp-core#auto-scaling-features)
+26
View File
@@ -0,0 +1,26 @@
---
title: First Deck
parent: Getting Started
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# First Deck
When creating a presentation, it's important to plan out your content and structure in advance to ensure that your message is clear and engaging. One way to do this is to break your presentation into a series of slides that each convey a specific point or idea.
![Alt text](pictures/FirstDeck.gif)
Here are some tips for creating effective slides in Marp:
1. First, start by writing your first slide. This slide should introduce your topic and grab your audience's attention. Keep it concise and to the point, and consider using a bold or eye-catching font to make it stand out.
2. Next, preview your slides to get a sense of the overall flow and structure of your presentation. Marp allows you to view your slides in real-time as you write, so you can see how each slide looks as you go.
3. For your second slide, consider adding a picture to help illustrate your point. Marp allows you to easily add images to your slides, and you can even set them as the background for your slide for added impact.
4. When designing your slides, don't forget to add a footer that includes your name, the date, and the title of your presentation. This helps to give your presentation a professional look and feel, and also makes it easier for your audience to keep track of where they are in the presentation.
5. Finally, consider changing the theme of your presentation to give it a unique and polished look. Marp comes with a range of built-in themes to choose from, or you can create your own custom theme using CSS for a truly personalized touch.
By following these tips and using Marp's simple and intuitive syntax, you can create engaging and effective presentations that captivate your audience and convey your message with clarity and impact.
+14
View File
@@ -0,0 +1,14 @@
---
title: Features
nav_order: 3
has_children: true
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Features
- [Slides Preview](21.SlidesPreview.md)
- [Slides Export](22.SlidesExport.md)
- [Slides Custom Theme](23.SlidesCustomTheme.md)
- [Presenting](24.Presenting.md)
+15
View File
@@ -0,0 +1,15 @@
---
title: Slides Preview
parent: Features
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Preview Slides
Marp for Obsidian lets you preview your Marp Markdown in real time, allowing you to instantly view changes as you make them! With this feature, you can quickly refine and perfect your Markdown documents.
![Slide Preview](pictures/DeckPreview.gif)
The preview of the content of active Markdow editor, use the ribbon icon or execute command from the Command Palette (<kbd>Ctrl/Cmd+P</kbd> + 'Slide Preview')
+23
View File
@@ -0,0 +1,23 @@
---
title: Slides Export
parent: Features
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Export slide deck (html, pdf, pptx, img)
We have integrated [Marp CLI](https://github.com/marp-team/marp-cli/) to export your deck into several formats.
To export the content of active Markdown editor execute command from the Command Palette (<kbd>Ctrl/Cmd+P</kbd>).
![Alt text](pictures/ExportPDF.gif)
## Supported file types
- **HTML** export
- **PDF** with or without annotation
- **PPTX** PowerPoint document
- **PNG** One file for every slide
> ⚠️ Export except HTML requires to install any one of [Google Chrome](https://www.google.com/chrome/), [Chromium](https://www.chromium.org/), or [Microsoft Edge](https://www.microsoft.com/edge). You may also specify the custom path for Chrome / Chromium-based browser by preference `CHEROME_PATH`.
+43
View File
@@ -0,0 +1,43 @@
---
title: Slides Custom Themes
parent: Features
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Use custom theme CSS
You can register and use [custom theme CSS for Marpit](https://marpit.marp.app/theme-css) / [Marp Core](https://github.com/marp-team/marp-core/tree/main/themes#readme) by setting `ThemePath`, that includes relative paths to local files in the current vault.
The registered theme can use by specifying theme name in [`theme` global directive](https://marpit.marp.app/directives?id=theme).
![Theme](pictures/Theme.gif)
Theme.css:
```css
/* @theme your-theme */
@import 'default';
section {
background: #fc9;
}
```
Slides.md:
```markdown
---
theme: your-theme
---
# Use your own theme
---
# Second Slide
```
Markdown preview will reload updated theme CSS automatically when you edited the registered local CSS file.
---
+12
View File
@@ -0,0 +1,12 @@
---
title: Presenting
parent: Features
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Presenting
Marp for Obsidian lets you present your Marp Markdown.
![Alt text](pictures/Presenting.gif)
+28
View File
@@ -0,0 +1,28 @@
---
title: Markdown-It Plugins
nav_order: 4
has_children: true
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Markdown-It
Markdown-it is a powerful and flexible Markdown parser that allows you to convert Markdown syntax into HTML. It’s widely used for rendering Markdown content on websites, blogs, and documentation.
## Markdown-it Plugins
Markdown-it supports community-written plugins. The Plugins can be loaded like this:
```js
const md = markdownit
.use(plugin1)
.use(plugin2, opts, ...)
.use(plugin3);
```
## Marp Slides Markdown-It Plugins
- [Mark](31.Markdown-it-Mark.md)
- [Containers](32.Markdown-it-Conteiners.md)
- [Kroki](33.Markdown-it-Kroki.md)
+30
View File
@@ -0,0 +1,30 @@
---
title: Markdown-It Mark
parent: Markdown-It Plugins
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Markdown-It Mark
Markup uses the same conditions as CommonMark [emphasis](http://spec.commonmark.org/0.15/#emphasis-and-strong-emphasis).
`==marked==` => `<mark>inserted</mark>`
## Sample
```markdown
---
# Text Highlights
**[markdown-it-mark](https://github.com/markdown-it/markdown-it-mark)**
This is ==marked== text
---
```
![alt text](pictures/plugin-mark.png)
## References
- [markdown-it-mark](https://github.com/markdown-it/markdown-it-mark)
+59
View File
@@ -0,0 +1,59 @@
---
title: Markdown-It Conteiners
parent: Markdown-It Plugins
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Markdown-It Container
With this plugin you can create block containers like:
```markdown
::: container
*here be dragons*
:::
```
.... and specify how they should be rendered. If no renderer defined, `<div>` with
container name class will be created:
```html
<div class="container">
<em>here be dragons</em>
</div>
```
## Sample
```markdown
---
<!-- _class: box-flex -->
# Columns Containers
**[markdown-it-container](https://github.com/markdown-it/markdown-it-container)**
::: container
## Colum 1
text dadadas text text text text text text text text text text
:::
::: container
## Colum 2
text
:::
---
```
![alt text](pictures/plugin-container.png)
## References
- [markdown-it-container](https://github.com/markdown-it/markdown-it-container)
+52
View File
@@ -0,0 +1,52 @@
---
title: Markdown-It Kroki
parent: Markdown-It Plugins
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# markdown-it-kroki
> This library was designed to embed [Kroki.io](https://kroki.io/) diagram into [Marp](https://marp.app/) slide decks!!
This library is a plugin for markdown-it to embed figure created by textual syntax.
To use this package, you can embed **Software Diagram** (like UML) written by **code** in Marp slide decks.
## Sample
```
@startuml
left to right direction
actor Guest as g
package Professional {
actor Chef as c
actor "Food Critic" as fc
}
package Restaurant {
usecase "Eat Food" as UC1
usecase "Pay for Food" as UC2
usecase "Drink" as UC3
usecase "Review" as UC4
}
fc --> UC4
g --> UC1
g --> UC2
g --> UC3
@enduml
```
![alt text](pictures/plugin-kroki.png)
If you want to write diagrams, you can use various syntaxes (such as [PlantUML](https://plantuml.com/) or [Mermaid](https://mermaid-js.github.io/mermaid/#/)) within fenced code blocks.
> [!NOTE]
> This package depends on [Kroki.io](https://kroki.io).
> If you want to know which **diagram languages are supported**,
> please check the official website at [https://kroki.io/](https://kroki.io/).
## References
- [markdown-it-kroki](https://github.com/kazumatu981/markdown-it-kroki)
+27
View File
@@ -0,0 +1,27 @@
---
title: Examples
nav_order: 5
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Examples
## Setup Vault
- clone and open
- install marp community plugin
- configure obsidian
- configure theme
![Vault Settings](pictures/VaultSettings.gif)
## Example Vault
We have created a dedicated Obsidian vault for testing the plugin and Marp presentations. It is a great way to explore the full potential of these tool without impacting your main vault or risking any data loss or corruption. By using a separate vault for testing, you can experiment freely and make changes without worrying about affecting your existing notes and files.
To set up a lab Obsidian vault, you can clone the [plugin repository](https://github.com/samuele-cozzi/obsidian-marp-slides) and open the vault folder with obsidian.
![Examples](pictures/Examples.gif)
One area where the lab vault can be especially useful is in testing Marp presentations. Marp is an open-source tool that allows users to create professional-looking presentations using simple Markdown syntax. By building and testing Marp presentations within your lab Obsidian vault, you can experiment with different formatting options and see how your presentations look and feel in a safe and isolated environment.
+314
View File
@@ -0,0 +1,314 @@
---
title: Changelog
nav_order: 99
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Changelog
## [0.45.6](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.45.5...0.45.6) (2024-05-08)
### Bug Fixes
* engine resolved on ubuntu ([8fe76a7](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/8fe76a7adb2605d8ee3d088265d47fcbcc3d37cd))
* engine resolved on ubuntu ([897fa14](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/897fa14d33cc4ce3780d350dcac74917d9e53d33))
* Merge pull request [#159](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/159) from samuele-cozzi:156-the-specified-engine-cannot-be-resolved ([8fe76a7](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/8fe76a7adb2605d8ee3d088265d47fcbcc3d37cd))
## [0.45.5](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.45.4...0.45.5) (2024-03-09)
### Bug Fixes
* enhancement of the doc ([235483a](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/235483a2ed8c1fa1fa7110a7dc4e53e3ca30d4b3))
## [0.45.4](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.45.3...0.45.4) (2024-03-09)
### Bug Fixes
* lib not found ([f3666a4](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/f3666a453fef14dc0f128d0f54da06b128d7126d))
## [0.45.3](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.45.2...0.45.3) (2024-03-09)
### Bug Fixes
* dependencies of markdown-it plugins ([657c0aa](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/657c0aa672b370e4daea7c16a229fbc6de9f0f89))
## [0.45.2](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.45.1...0.45.2) (2024-03-09)
### Bug Fixes
* file is null ([d53c34e](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/d53c34e37efebe04858e36484815966437012918))
## [0.45.1](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.45.0...0.45.1) (2024-03-09)
### Bug Fixes
* file parent null ([8140a6a](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/8140a6a16199ce32ddadf8559a8bf8d466b5c2fc))
## [0.45.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.44.0...0.45.0) (2024-03-09)
### Features
* Merge pull request [#144](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/144) from samuele-cozzi:134-highlighting-missing ([50c4453](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/50c4453f1d2c55f52ebbf0b10417fcb01ae189d2))
## [0.44.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.43.0...0.44.0) (2024-01-31)
### Features
* Merge pull request [#140](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/140) from samuele-cozzi:139-external-images-dont-appear-in-deck-preview ([43e829f](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/43e829fe4ed98ee504bcb5b3778f9815a8a91489))
## [0.43.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.42.2...0.43.0) (2024-01-20)
### Features
* mobile app alpha ([6d5f50c](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/6d5f50c1f25f1a9cf35247def50c23c581b0b3f0))
## [0.42.2](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.42.1...0.42.2) (2024-01-18)
### Bug Fixes
* issues 129, 130 suggestion ([57d4ce5](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/57d4ce5fd4d32bc5b3a780e786a71e473f7695ec))
## [0.42.1](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.42.0...0.42.1) (2024-01-07)
### Bug Fixes
* error Line selection listener ([d37a358](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/d37a35856e22c7921162067c665eec0e63beae92))
* Merge pull request [#131](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/131) from samuele-cozzi:130-v0420-breaks-other-plugins-suggestion-completion ([d37a358](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/d37a35856e22c7921162067c665eec0e63beae92))
## [0.42.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.41.0...0.42.0) (2023-12-24)
### Features
* Merge pull request [#126](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/126) from samuele-cozzi:124-synchronize-scrolling-of-markdown-editing-view-and-slide-preview-view ([9ebc658](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/9ebc658222b558806e7e5d55b80fe4a3ed872d17))
* sync code editor and preview ([9ebc658](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/9ebc658222b558806e7e5d55b80fe4a3ed872d17))
## [0.41.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.40.0...0.41.0) (2023-11-22)
### Features
* Merge pull request [#121](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/121) from samuele-cozzi:116-how-to-export-the-powerpoint-document ([16adf12](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/16adf120d5640d65628f8107ce9466d706ef66f5))
* shortcut for export pptx ([16adf12](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/16adf120d5640d65628f8107ce9466d706ef66f5))
* shortcut for export pptx ([5efbe82](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/5efbe8266ba4d94cd43b87c328c9e59c576db717))
## [0.40.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.39.0...0.40.0) (2023-11-22)
### Features
* documentation tree ([d66318e](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/d66318e1357b930dbd6fa647f2cf6e2b15588c5c))
## [0.39.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.38.1...0.39.0) (2023-10-31)
### Features
* release new version ([9f8a6e1](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/9f8a6e179314dc87da59985e9ae58bdb8287c050))
## [0.38.1](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.38.0...0.38.1) (2023-10-27)
### Bug Fixes
* enable advanced html ([88a95ae](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/88a95aefb072f0f9963779b962f5f70a42797e47))
* Merge pull request [#109](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/109) from samuele-cozzi/108-html-enhanced-view ([88a95ae](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/88a95aefb072f0f9963779b962f5f70a42797e47))
## [0.38.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.37.1...0.38.0) (2023-09-10)
### Features
* presents slides ([515ce27](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/515ce27df87d7316c8b27ed3566d4c366b51a727))
## [0.37.1](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.37.0...0.37.1) (2023-08-06)
### Bug Fixes
* Update README.md ([5ea42d9](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/5ea42d93096d62dd017fb98d36d27bbf4b01a300))
## [0.37.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.36.1...0.37.0) (2023-06-24)
### Features
* advanced html export ([14523f9](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/14523f9fbf642674a56f154c3c1f47b271972eb7))
* advanced html export ([41e77f3](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/41e77f310dbf5ca04f9f915df9b9dc9fdc4d14ba))
* Merge pull request [#94](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/94) from samuele-cozzi:feature/advanced-html-export ([14523f9](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/14523f9fbf642674a56f154c3c1f47b271972eb7))
## [0.36.1](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.36.0...0.36.1) (2023-06-22)
### Bug Fixes
* add plugin copy package ([ca85ae4](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/ca85ae49ecf2ef365646deee259e2cdc7c0bffcb))
## [0.36.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.35.0...0.36.0) (2023-06-22)
### Features
* advanced html export ([310777a](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/310777ab9fabaf6b3d275fcbe17d02129fb94475))
## [0.35.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.34.5...0.35.0) (2023-06-22)
### Features
* github action ([7a31ceb](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/7a31ceb58b60124fe0ca35d0fe2e129dba6b594d))
* html advanced ([62317d1](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/62317d1418090077f3e4c24e2088075ce30731fb))
## [0.34.5](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.34.4...0.34.5) (2023-06-22)
### Bug Fixes
* add comment ([06f435f](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/06f435f0ba7a5dbf4cc0a2d99edb4f27628c691c))
## [0.34.4](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.34.3...0.34.4) (2023-06-22)
### Bug Fixes
* add js files ([1d5ef78](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/1d5ef7825d296495d6c5a75b1daa1317b4ce0223))
## [0.34.3](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.34.2...0.34.3) (2023-06-22)
### Bug Fixes
* main ([7a0cf0d](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/7a0cf0da033166dc148da694d2f3f2c1e6a10dfc))
## [0.34.2](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.34.1...0.34.2) (2023-06-22)
### Bug Fixes
* main ([cbd1b89](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/cbd1b89158277333fdd654b58dc47c0698f715ec))
## [0.34.1](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.34.0...0.34.1) (2023-06-22)
### Bug Fixes
* main file ([c2f5d00](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/c2f5d00a20a7ebf4116f6dac36ff689fa97142d5))
## [0.34.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.33.1...0.34.0) (2023-06-22)
### Features
* advanced html ([a19ed79](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/a19ed790b4c02570cb8d3a23a9b804141eab8bc5))
## [0.33.1](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.33.0...0.33.1) (2023-05-25)
### Bug Fixes
* images import ([9504a37](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/9504a37213665dfddc8669abb40b56091464d452))
## [0.33.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.32.0...0.33.0) (2023-05-22)
### Features
* export on preview ([e8fd63e](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/e8fd63e6ee127208f5e1e01438bd3211bac73a2f))
## [0.32.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.31.0...0.32.0) (2023-05-11)
### Features
* Settings: Math Typesettings [#71](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/71) ([#74](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/74)) ([9e9c00f](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/9e9c00f9befc548f6159723a46e454aba905b475))
## [0.31.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.30.2...0.31.0) (2023-05-11)
### Features
* enable HTML setting ([#72](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/72)) ([97bd5b9](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/97bd5b9a1f744ea7a7fd50739ceefa142b356ae1))
## [0.30.2](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.30.1...0.30.2) (2023-04-28)
### Bug Fixes
* main.js location for deployment ([#65](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/65)) ([5a4ed39](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/5a4ed39b68887f1e0a674dd2771835e06aa570b3))
## [0.30.1](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.30.0...0.30.1) (2023-04-28)
### Bug Fixes
* local development ([4543176](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/4543176c9751ee71b1fa78a0e8955839e3ee12ba))
* local development ([3368d82](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/3368d82a3be159d52331544c1b3e8fd034913dab))
* Merge pull request [#63](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/63) from samuele-cozzi:fix/release-0.30 ([4543176](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/4543176c9751ee71b1fa78a0e8955839e3ee12ba))
## [0.30.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.29.1...0.30.0) (2023-04-28)
### Features
* autoscaling base ([#61](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/61)) ([d3e0fca](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/d3e0fca67f8944f2a6df93ae62410c9b381342ac))
## [0.29.1](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.29.0...0.29.1) (2023-03-15)
### Bug Fixes
* fixes for publish plugin ([#58](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/58)) ([01cd1f5](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/01cd1f5cbdb9c8ff23b5d773b8d2a9f2935685f4))
## [0.29.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.28.2...0.29.0) (2023-03-09)
### Features
* Features/docs base ([#56](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/56)) ([6a8076b](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/6a8076b888c16e5aaa57c96f297e34e84f12b46b))
## [0.28.2](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.28.1...0.28.2) (2023-03-08)
### Bug Fixes
* unit tests ([da08b9b](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/da08b9b122e6cfd1d5e14c6374521885ddb421cb))
## [0.28.1](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.28.0...0.28.1) (2023-03-08)
### Bug Fixes
* normalize path of pictures ([#53](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/53)) ([c362ae5](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/c362ae56a3d931bf154e4a2d043890f380a31760)), closes [#46](https://github.com/samuele-cozzi/obsidian-marp-slides/issues/46)
## [0.28.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.27.0...0.28.0) (2023-03-08)
### Features
* unit tests ([bc07f3c](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/bc07f3c0d3a4d58c55f2b0d2794f07826047b74e))
## [0.27.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.26.0...0.27.0) (2023-03-08)
### Features
* add unit tests ([f0cc955](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/f0cc955a9c08313cf6db663677a885342d56afa3))
## [0.26.0](https://github.com/samuele-cozzi/obsidian-marp-slides/compare/0.25.0...0.26.0) (2023-03-04)
### Features
* move changelog ([ce87295](https://github.com/samuele-cozzi/obsidian-marp-slides/commit/ce87295fbbe2171a017238eaa4129ec31abc214f))
+69
View File
@@ -0,0 +1,69 @@
---
title: Developer Guide
nav_order: 6
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Developer Guide
## Develop & Test new Features
To get started, initiate the process by cloning this repository to your local environment. This will create a local copy of the entire project, allowing you to work on, modify, and contribute to the codebase seamlessly
```bash
$ git clone https://github.com/samuele-cozzi/obsidian-marp-slides.git
```
For testing purposes, make modifications to the esbuild.config.mjs file. This file contains configuration settings for esbuild, and adjusting its parameters will allow you to experiment with different build options and observe their effects on your project.
form:
```js
//outfile: "vault/.obsidian/plugins/marp-slides/main.js", //for local dev!!!
outfile: "main.js",
```
to:
```js
outfile: "vault/.obsidian/plugins/marp-slides/main.js", //for local dev!!!
//outfile: "main.js",
```
Proceed to compile and run the code. This step will apply your changes and generate the executable output, providing an opportunity to test and validate the impact of your configuration adjustments on the project's build and runtime behavior
```bash
# get packages
npm install
# biuld, test, run
npm run build
npm run test
npm run dev
```
Open the simple vault and test and validate the changes.
PLEASE REMEMBER: not commit the `esbuild.config.mjs` file!
## Create new Release
This repository use [Release please](https://github.com/googleapis/release-please) to automate CHANGELOG generation, the creation of GitHub releases, and version bumps.
"Release Please" is a GitHub Action that automates the release management process for software projects hosted on GitHub. Developed by Google, "Release Please" is designed to simplify the creation of GitHub releases by automatically generating release notes based on the changes made in the codebase since the last release.
The workflow involves using the tool to analyze the commit history, detect semantic version bumps (such as bug fixes, new features, or breaking changes), and compile release notes accordingly. It can then automatically create a new release on GitHub, including the generated release notes and a version tag.
### Create git commits or Merge commits
Release Please assumes you are using [Conventional Commit messages](https://www.conventionalcommits.org/).
The most important prefixes you should have in mind are:
* `fix:` which represents bug fixes, and correlates to a [SemVer](https://semver.org/)
patch.
* `feat:` which represents a new feature, and correlates to a SemVer minor.
* `feat!:`, or `fix!:`, `refactor!:`, etc., which represent a breaking change
(indicated by the `!`) and will result in a SemVer major.
+24
View File
@@ -0,0 +1,24 @@
###########################################################
### Welcome to Beautiful Jekyll!
### This config file is meant for settings that affect your entire website. When you first
### set up your website you should go through all these settings and edit them, but after
### the initial set up you won't need to come back to this file often.
###########################################################
############################
# --- Required options --- #
############################
# Name of website
title: Obsidian Marp
# Your name to show in the footer
author: Samuele Cozzi
###############################################
# --- List of links in the navigation bar --- #
###############################################
remote_theme: just-the-docs/just-the-docs
plugins:
- jekyll-remote-theme
+26
View File
@@ -0,0 +1,26 @@
---
title: Home
nav_order: 1
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
# Index
## Getting Started
- [Setup Vault](11.SetupVault.md)
- [Configuration](12.Configuration.md)
- [Marp Syntax](13.MarpSyntax.md)
- [First Deck](14.FirstDeck.md)
## Features
- [Slides Preview](21.SlidesPreview.md)
- [Slides Export](22.SlidesExport.md)
- [Slides Custom Theme](23.SlidesCustomTheme.md)
## Examples
- [Setup Vault](30.Examples.md#setup-vault)
- [Example Vault](30.Examples.md#example-vault)
Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 136 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 492 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 485 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 504 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 308 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 867 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 224 KiB

File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 101 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 178 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 332 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 198 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 112 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 123 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

File diff suppressed because one or more lines are too long
+942
View File
@@ -0,0 +1,942 @@
---
marp: true
size: 16:9
theme: am_blue
paginate: true
headingDivider:
- 2
- 3
footer: \ *初虹(虹鹄山庄)* *Awesome Marp:轻松取代 LaTeX Beamer!* *2024年1月13日(v1.3)*
created: 2025-09-09T18:22
updated: 2025-09-22T13:27
---
<!-- _class: cover_a
<!-- _header: "" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
# Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
## Awesome Marp 有什么?
<!-- _class: cols2_ol_ci fglass toc_a -->
<!-- _footer: "" -->
<!-- _header: "CONTENTS" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
## 1. 关于模板
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 1. 关于模板
- **开始之前:** 你需要知道这样几个工具,Markdown、Markdown 编辑器(VS Code 或 Obsidian)和 Marp。关于这三者是个啥,我不做详细地介绍,但在[第 55 页](#55)-[第 58 页](#58)会有一些凝练性的内容给你参考,同时我提供了不少的链接,也供你参阅。
- **为什么要开发 Awesome Marp?**
- Marp 原生仅提供 3 种主题(`default` / `gaia` / `uncover`),呈现效果一般。于是我根据自己的使用情况,边用边改造,陆续打磨了这样的一整套模板。
- **目前发布的 v1.3 有 38 个自定义样式、6 种颜色的主题**(后面有呈现效果)
- **Awesome Marp 的几个特色:**
- 支持分栏呈现、支持 Callouts(类似于 Beamer 中的定理框)、提供多种类型的封面页和目录页、可以实现导航进度栏、图片支持自定义居中/居左/居右对齐等
- 本着「开箱即用」的原则,我将本项目文件夹打包上传到了[GitHub](https://github.com/favourhong/Awesome-Marp) 和 [Gitee](https://gitee.com/favourhong/Awesome-Marp)
- 用到的工具:软件 [Visual Studio Code](https://code.visualstudio.com) 或 [Obsidian](https://obsidian.md/)、[Marp for VScode(插件)](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode)
## 1. 关于模板
- Awesome Marp 支持 38 个自定义样式,使用时需在页面指定(如 `<!-- _class: trans -->`):
| 封面页 | 目录页 | 列表 | 引用盒子 | 其他 1 | 其他 2 |
| --------- | ------- | ----------- | ----------- | ----------------------------- | --------------------------------------------------------------- |
| `cover_a` | `toc_a` | `cols-2` | `bq-black` | 过渡页面 `trans` | 图表等的标题 `caption` |
| `cover_b` | `toc_b` | `cols-2-64` | `bq-purple` | 最后一页 `lastpage` | 非嵌套无序列表的毛玻璃效果 `fglass` |
| `cover_c` | | `cols-2-73` | `bq-red` | 导航栏 `navbar` | 脚注:`footnote` |
| `cover_d` | | `cols-3` | `bq-blue` | 标题固定+无底色 `fixedtitleA` | 调节字体大小:`tinytext`/`smalltext`/<br>`largetext`/`hugetext` |
| `cover_e` | | `cols-2-46` | `bq-green` | 标题固定+有底色 `fixedtitleB` | |
| | | `cols-2-37` | | 两列有序列表 `cols2_ol_sq/ci` | |
| | | `rows-2` | | 两列无序列表 `cols_ul_sq/ci` | |
| | | `pin-3` | | 单列有序列表 `col1_ul_sq/ci` | |
## 1. 关于模板
- Awesome Marp 的主题色(6 种),可在 YAML 区切换 Theme,如 `theme: am_dark`:
| 深色 | 绿色 | 红色 | 蓝色 | 棕色 | 紫色
|---------|----------|--------|---------|----------|----|
| `am_dark` | `am_green` | `am_red` | `am_blue` | `am_brown` |`am_purple`|
## 1. 关于模板
- 如何使用:
- **搭配 VS Code**:直接使用 VS Code 打开 `Awesome-Marp` 文件夹
- 如果你想「拿来即用」,直接根据我分享的 Markdown 源码文件,对照修改就好了~
- 如果你对部分效果不满意、期望简单微调的话,目前在 `Awesome-Marp/themes` 下有 6 个 CSS 文件,这些 CSS 文件决定了 Markdown 源码的最终渲染效果,可以试着改一改~
- 如果你能够自行定制个性化 CSS 文件,渲染前,别忘在 `Awesome-Marp/.vscode/settings.json` 里加上你的 CSS 文件路径~
- **搭配 Obsidian**:安装 [Marp Slides 插件](https://github.com/samuele-cozzi/obsidian-marp-slides),并配置相应 CSS 路径
- 字体:因担心版权问题,需自行下载字体并安装,Awesome Marp 用到的字体有:
- 正文字体:`Latin Modern Math`、`方正宋刻本秀楷简体`,如果未安装,默认将使用 `Calibri` 和 `楷体`
- 标题字体:`Optima LT Medium`、`方正苏新诗柳楷简体`,如果未安装,默认将使用 `Arial` 和 `黑体`
- 脚注字体:`Charm` 和 `叶根友毛笔行书修正版`,如果未安装,默认将使用 `Calibri` 和 `楷体`
- 代码字体:`Fira Code` 和 `霞鹜文楷等宽`,如果未安装,默认将使用 `Consolas` 和 `华文中宋`
## 1. 关于模板:更新日志
- [Awesome Marp v1.0:我开发了一整套 Marp 主题,Markdown 转换的 PPT 也可以很好看!](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486787&idx=1&sn=2652ddae81f50240844cb652780912e1&chksm=c13ff94bf648705da1ba986b91265e3ff018acaffcfa60d7807a81be22176005e7a2b4483627&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.1:标题行不随正文浮动,这下更像 Beamer 了!](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486800&idx=1&sn=527348e242576079e4bd6cd1823c823a&chksm=c13ff958f648704e40a202db6ad5fa215ef4c189d66403e161d6ace9828406a8747ac755684f&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.2:增加脚注、调节字体大小等样式~](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486825&idx=1&sn=56d632ce164831438ec87c1b20ed4c4c&chksm=c13ff961f64870774f069ab816340783d8f54fd6b89363b8d9412c593efc640851ce9edd8833&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.3:几处小更新~](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486869&idx=1&sn=fcc377ff6a5930436e5078a09d53f0ab&chksm=c13ff99df648708b89bafba030b27909d0022279e26da723ca54a1666fe55f50a4230f050662&scene=178&cur_album_id=3132459596339757070#rd)
## 下面让我们看看效果吧 ~
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 2. 封面页
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 2. 封面页
- 大标题:采用一级标题 `# ` (如:`# Awesome Marp:自定义 Marp 主题`)
- 副标题:采用六级标题 `###### ` (如:`###### 打造简便又不失个性的演示文稿`)
- 本套模板提供 5 种封面页样式,使用时需要在页面中设定局部指令,如:`<!-- _class: cover_a -->`
- `cover_a`:[第 1 种](#1)
- `cover_b`:[第 2 种](#12)
- `cover_c`:预留 header 可设定学校 logo,footer 可设定校训 [第 3 种](#13)
- `cover_d`:只预留了 footer 设定校训 [第 4 种](#14)
- `cover_e`:预留 header 设定学校 logo,footer 设定学校 logo 和学校名称[第 5 种](#15)
- 如果已经设定了全局 footer、header 或页码,但又不期望在封面页中出现,可以 `<!-- _footer: "" -->` / `<!-- _header: "" -->` / `<!-- _paginate: "" -->` 分别将其局部隐藏起来
- 当标题文字超过页面宽度会溢出换行,这里可以使用 `<!-- fit -->` 根据页面宽度自动调整文字大小
---
<!-- _class: cover_b -->
<!-- _header: "" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
# Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_c -->
<!-- _paginate: "" -->
<!-- _footer: 厚德博学 经济匡时 -->
<!-- _header: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291116463.png) -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_d -->
<!-- _paginate: "" -->
<!-- _footer: "厚德博学 经济匡时" -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_e -->
<!-- _paginate: "" -->
<!-- _footer: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291116463.png) -->
<!-- _header: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291053273.png) -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
## 3. 目录页
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 3. 目录页
- Awesome Marp 提供了至少 2 种目录页样式,使用时同样需要设定局部样式
- `toc_a`:需要将 header 的内容设定为 `CONTENTS`,即 `<!-- _header: "CONTENTS" -->`
- `toc_b`:需要将 header 的内容设定为 `目录<br>CONTENTS<br>你的LOGO地址`,即 `<!-- _header: 目录<br>CONTENTS<br>![](./logo.png)-->`
- 提供的几种分栏列表样式,也可以作为目录页使用,如 `<!-- _class: cols2_ol_ci fglass -->`(效果见[这里](#32))
- 类似地,如果已经定义了全局 footer 或页码,可以使用 `<!-- _footer: "" -->` / `<!-- _paginate: "" -->` 分别将其局部隐藏起来
- 目录页样式:[第 1 种](#2)、[第 2 种](#18)和[第 3 种](#19)
---
<!-- _class: toc_a -->
<!-- _header: "CONTENTS" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
---
<!-- _header: 目录<br>CONTENTS<br>![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291053273.png)-->
<!-- _class: toc_b -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
## 4. 页面分栏与列表分列
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 4.1 页面分栏与列表分列:页面分栏
- Awesome Marp 提供了 8 种页面分栏方式,分别为:
- `cols-2`:[两列分栏,五五平分](#23)
- `cols-2-64`:[两列分栏,六四分](#24)
- `cols-2-73`:[两列分栏,七三分](#25)
- `cols-2-46`:[两列分栏,四六分](#26)
- `cols-2-37`:[两列分栏,三七分](#27)
- `cols-3`:[三列分栏,平分](#28)
- `rows-2`:[两行分栏](#29)
- `pin-3`:[品字型分栏](#30)
- 如果某一栏为图片,可以将 `class=ldiv` 换成 `class=limg`,这样能够实现图片的垂直居中对齐呢(`class=ldiv` 为居上对齐)
## 4.1 页面分栏与列表分列:页面分栏
- 以 `<!-- _class: cols-2 -->` 为例,Markdown 的源码为:
```markdown
<!-- _class: cols-2 -->
<div class=ldiv>
第一列(左侧栏)的内容在这里
内容可以是普通纯文本,可以是列表,也可以是引用块、链接、图片等
</div>
<div class=rdiv>
第二列(右侧栏)的内容在这里
</div>
```
- 如果是分三栏(`<!-- _class: cols-3 -->`),还需要再增加 `<div class="mdiv"></div>` 标签
## 《荷塘月色》(两栏五五分)
<!-- _class: cols-2 -->
<div class=ldiv>
曲曲折折的荷塘上面,弥望的是田田的叶子。叶子出水很高,像亭亭的舞女的裙。
层层的叶子中间,零星地点缀着些白花,有袅娜地开着的,有羞涩地打着朵儿的;正如一粒粒的明珠,又如碧天里的星星,又如刚出浴的美人。
微风过处,送来缕缕清香,仿佛远处高楼上渺茫的歌声似的。这时候叶子与花也有一丝的颤动,像闪电般,霎时传过荷塘的那边去了。
叶子本是肩并肩密密地挨着,这便宛然有了一道凝碧的波痕。叶子底下是脉脉的流水,遮住了,不能见一些颜色;而叶子却更见风致了。
—— 朱自清《荷塘月色》 [返回](#21)
</div>
<div class=rimg>
<!-- ![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221014499.png) -->
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221630151.png)
</div>
## 《春》(两栏六四分)
<!-- _class: cols-2-64 -->
<div class=limg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201217248.png)
</div>
<div class=rdiv>
盼望着,盼望着,东风来了,春天的脚步近了。
一切都像刚睡醒的样子,欣欣然张开了眼。山朗润起来了,水涨起来了,太阳的脸红起来了。
小草偷偷地从土里钻出来,嫩嫩的,绿绿的。园子里,田野里,瞧去,一大片一大片满是的。坐着,躺着,打两个滚,踢几脚球,赛几趟跑,捉几回迷藏。风轻悄悄的,草软绵绵的。
—— 朱自清《春》
[返回](#21)
</div>
## 经典散文诗篇(两栏七三分)
<!-- _class: cols-2-73 -->
<div class=limg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221010523.png)
</div>
<div class=rdiv>
经典的散文诗篇有:
- 朱自清:《荷塘月色》
- 林清玄:《月到天心》
- 郁达夫:《古都的秋》
- 张爱玲:《花落的声音》
- 余光中:《听听那冷雨》
- 张抗抗:《牡丹的拒绝》
- 丰子恺:《杨柳》
- 周作人:《乌篷船》
- 郑振铎:《石湖》
- 梁实秋:《雅舍》
[返回](#21)
</div>
## 《春》(两栏四六分)
<!-- _class: cols-2-46 -->
<div class=ldiv>
盼望着,盼望着,东风来了,春天的脚步近了。
一切都像刚睡醒的样子,欣欣然张开了眼。山朗润起来了,水涨起来了,太阳的脸红起来了。
小草偷偷地从土里钻出来,嫩嫩的,绿绿的。园子里,田野里,瞧去,一大片一大片满是的。坐着,躺着,打两个滚,踢几脚球,赛几趟跑,捉几回迷藏。风轻悄悄的,草软绵绵的。
—— 朱自清《春》
[返回](#21)
</div>
<div class=rimg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201217248.png)
</div>
## 经典散文诗篇(两栏三七分)
<!-- _class: cols-2-37 -->
<div class=ldiv>
经典的散文诗篇有:
- 朱自清:《荷塘月色》
- 林清玄:《月到天心》
- 郁达夫:《古都的秋》
- 张爱玲:《花落的声音》
- 余光中:《听听那冷雨》
- 张抗抗:《牡丹的拒绝》
- 丰子恺:《杨柳》
- 周作人:《乌篷船》
- 郑振铎:《石湖》
- 梁实秋:《雅舍》
[返回](#21)
</div>
<div class=rimg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221010523.png)
</div>
## 夏与秋(三栏三平分)
<!-- _class: cols-3 -->
<div class=ldiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201206630.png)
</div>
<div class=mdiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201151809.png)
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201158036.png)
</div>
<div class=rdiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201154535.png)
[返回](#21)
</div>
## 高山与沙漠(两行分栏)
<!-- _class: rows-2 -->
<div class="timg">
![#c h:250](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131736186.png)
</div>
<div class="bimg">
![#c h:260](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131737821.png)
</div>
## 《宇宙的奥秘》(品字型分栏)
<!-- _class: pin-3 -->
<div class="tdiv">
> 四百年前,两位截然不同的科学家突破了当时已知世界的边界。1609 年在威尼斯,伽利略・伽利雷透过望远镜观察星辰,并制作仪器和进行实验。在布拉格,科班出身的神学家约翰内斯・开普勒发现了行星运动定律,奠定了近代天体物理学的基础,并思考着宇宙的宏伟构造。托马斯・德・帕多瓦以至今较少受到关注却扣人心弦的通信往来为基础,讲述了这两位类型如此迥异的学者之间不对等的关系,以及他们如何在同样的时刻却以各自的方式探索星辰的奥秘。在彼此的鉴照下,他们的远见与固执、睿智与无知得以呈现。这是一部介绍新科学的崛起以及近代来临之际的巨大变革的作品。 ——《宇宙的奥妙》
</div>
<div class="limg">
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131712626.png)
</div>
<div class="rimg">
![#c h:260](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131713779.png)
</div>
## 4.2 页面分栏与列表分列:列表分列
Awesome Marp v1.3 提供了 6 种列表分列的方式,分别为:
- `cols2_ol_sq`:呈现效果为[有序列表 + 方形序号](#32)
- `cols2_ol_ci`:呈现效果为[有序列表 + 圆形序号](#33)
- `cols2_ul_sq`:呈现效果为[无序列表 + 方形序号](#34)
- `cols2_ul_ci`:呈现效果为[无序列表 + 圆形序号](#35)
- `col1_ul_sq`:呈现效果为[有序列表 + 方形序号](#36)
- `col1_ul_ci`:呈现效应为[有序列表 + 圆形序号](#37)
## 《微观经济学:现代观点》
<!-- _class: cols2_ol_sq fglass -->
渲染效果为**有序列表+方形序号**
自定义样式为:`<!-- _class: cols2_ol_sq fglass -->`
- 偏好和效用
- 预算约束和消费者的最优选择
- 需求函数
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 博弈论
- 交换经济与生产经济
- 外部性与公共品
- 不确定性、期望效用和不对称信息
[返回](#28)
## 《微观经济学:现代观点》
<!-- _class: cols2_ol_ci fglass -->
渲染效果为**有序列表+圆形序号**
自定义样式为:`<!-- _class: cols2_ol_ci fglass -->`
- 偏好和效用
- 预算约束和消费者的最优选择
- 需求函数
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 博弈论
- 交换经济与生产经济
- 外部性与公共品
- 不确定性、期望效用和不对称信息
[返回](#28)
## 《置身事内》
<!-- _class: cols2_ul_sq fglass -->
渲染效果为**无序列表+方形序号**
自定义样式为:`<!-- _class: cols2_ul_sq fglass -->`
- 第一章:地方政府的权力与事务
- 第二章:财税与政府行为
- 第三章:政府投融资与债务
- 第四章:工业化中的政府角色
- 第五章:城市化与不平衡
- 第六章:债务与风险
- 第七章:国内国际失衡
- 第八章:政府与经济发展
[返回](#28)
## 《置身事内》
<!-- _class: cols2_ul_ci fglass -->
渲染效果为**无序列表+圆形序号**
自定义样式为:`<!-- _class: cols2_ul_ci fglass -->`
- 第一章:地方政府的权力与事务
- 第二章:财税与政府行为
- 第三章:政府投融资与债务
- 第四章:工业化中的政府角色
- 第五章:城市化与不平衡
- 第六章:债务与风险
- 第七章:国内国际失衡
- 第八章:政府与经济发展
[返回](#28)
## 《微观经济学:现代观点》
<!-- _class: col1_ol_sq fglass -->
渲染效果为**单列+有序列表+方形序号**
自定义样式为:`<!-- _class: col1_ul_sq fglass -->`
- 预算约束和消费者的最优选择
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 交换经济与生产经济
- 不确定性、期望效用和不对称信息
## 《微观经济学:现代观点》
<!-- _class: col1_ol_ci fglass -->
渲染效果为**单列+有序列表+圆形序号**
自定义样式为:`<!-- _class: col1_ul_ci fglass -->`
- 预算约束和消费者的最优选择
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 交换经济与生产经济
- 不确定性、期望效用和不对称信息
## 5. 引用、链接和 Callouts
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 5. 引用、链接和 Callouts
- 引用的呈现效果为:
> 合成控制法 (Synthetic Control Method) 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。
- 链接的呈现效果:
- [经管数据清洗与 Stata 实战:三大地级市数据库和 CSMAR 上市公司数据](https://mp.weixin.qq.com/s/D0cYVPJJsNiu61GcYwV6cg)
- [Stata 基础:从论文文件夹体系的建立说起](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486489&idx=1&sn=2eb51e85a01541c7a552a9434e087512&scene=21#wechat_redirect)
- Callouts 是 Awesome Marp 提供的自定义的样式,有 5 种颜色可选:
- [紫色](#40):`bq-purple`
- [蓝色](#41):`bq-blue`
- [绿色](#42):`bq-green`
- [红色](#43):`bq-red`
- [黑色](#44):`bq-black`
## 5. 引用、链接和引用盒子
<!-- _class: bq-purple -->
- 自定义样式为:`<!-- _class: bq-purple -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-blue -->
- 自定义样式为:`<!-- _class: bq-blue -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-green -->
- 自定义样式为:`<!-- _class: bq-green -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-red -->
- 自定义样式为:`<!-- _class: bq-red -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-black -->
- 自定义样式为:`<!-- _class: bq-black -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 6. 导航栏
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 6. 导航栏
<!-- _class: navbar -->
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* **导航栏** *基础知识*-->
- 一句题外话:打造 Awesome Marp 模板的最早初衷就是来自几位公众号粉丝朋友的询问,「Marp 是否也能实现想 Beamer 那样的顶部导航栏?」为了实现导航栏的效果,我又多学了一些 CSS 的知识,这套模板才得以成型
- 自定义样式为 `navbar`:`<!-- _class: navbar -->`
- 导航栏修改自 header,最前面必须加入 `\ `
- 当前活动标题,使用粗体 `**粗体**`
- 其余非活动标题,使用斜体 `*斜体*`
- 如果左侧有文字,需要使用斜粗体 `***粗斜体***`
- 默认根据内容自动分配间距,如果希望右对齐,可以手动增加空格的方式来推动右对齐
## 6. 导航栏
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* **导航栏** *基础知识*-->
<!-- _class: navbar -->
这张页面的部分 Markdown 源码:
```markdown
<!-- _class: navbar -->
<!-- _header: \ ***虹鹄山庄***
- 自定义样式为 `navbar`:`<!-- _class: navbar -->`
- 导航栏修改自 header,最前面必须加入 `\ `
- 当前活动标题:使用粗体 `**粗体**`
- 其余非活动标题:使用斜体 `*斜体*`
- 如果左侧有文字:使用斜粗体 `***粗斜体***`
- 默认根据内容自动分配间距,如果希望右对齐,可以手动增加空格的方式来推动右对齐
```
## 7. 其他自定义样式
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 7.1 固定标题行:更像 Beamer 了(`fixedtitleA`)
<!-- _class: fixedtitleA -->
- 自定义样式:`<!-- _class: fixedtitleA -->`
- 使当前页面的标题栏固定在顶部,而非随着内容的多少浮动
- 同时,页面内容也会从顶部起笔,而非垂直方向上居中显示
## 7.1 固定标题行:更像 Beamer 了(`fixedtitleB`)
<!-- _class: fixedtitleB -->
<div class="div">
- 自定义样式:`<!-- _class: fixedtitleB -->`
- `fixedtitleB` 相比于 `fixedtitleA`,标题增加了底色色块,同时缩小了标题大小
- 其余效果与 `fixedtitleA` 相同
- 但是页面正文内容需要包裹在 `<div class="div'></div>` 标签中
</div>
---
<!-- _class: footnote -->
<div class="tdiv">
#### 7.2 脚注的自定义样式:`footnote`
使用方法:
- 自定义样式:`<!-- _class: footnote -->`
- 页面除脚注外的其他内容,写在 `<div class = "tdiv"></div>`
- 页面的脚注内容,写在 `<div class = "bdiv"></div>`
举个例子,展示一下显示效果:
- 一方面,经济金融化程度的加深,使得金融部门能够凭借资本跨期配置提前抽取其他部门的未来价值,从而扩大金融和非金融部门之间的外部收入差距$^1$。另一方面,经济金融化不断增加企业股东权力,促使企业更加追求股东价值最大化,这一导向将弱化普通劳动者阶层的议价能力,食利者阶层的财产性收入增加必然会挤压劳动收入份额,从而扩大了内部收入差距$^2$。
</div>
<div class="bdiv">
1 张甜迪. 金融化对中国金融、非金融行业收入差距的影响[J]. 经济问题, 2015(11): 40-46.
2 Hein E. Finance-dominated capitalism and re-distribution of income: a Kaleckian perspective[J]. Cambridge Journal of Economics, 2015, 39(3): 907-934.
</div>
## 7.3 调节文字大小的自定义样式
<!-- _class: largetext -->
对于字体大小的调节,直接修改 CSS 文件应该很方便的。但有小伙伴提出,“希望可以增加字体调节的自定义样式”,于是目前提供了四种微调样式:
- 自定义样式 1:`<!-- _class: tinytext -->` (是默认字体大小的 0.8 倍)
- 自定义样式 2:`<!-- _class: smalltext -->` (是默认字体大小的 0.9 倍)
- 自定义样式 3:`<!-- _class: largetext -->` (是默认字体大小的 1.15 倍)
- 自定义样式 4:`<!-- _class: hugetext -->` (是默认字体大小的 1.3 倍)
比如,本页面采用的自定义样式为 `largetext`
## 7.4 图表标题的自定义样式:`caption`
<!-- _class: caption -->
- 通过 `<div class="caption">宇宙的奥妙</div>` 来定义图表的标题
![#c h:380](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131712626.png)
<div class="caption">
宇宙的奥妙
</div>
## 需要知道的基础知识……
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## Markdown 概览
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar -->
- Markdown 是一种**极轻量**的文本标记语言,允许人们使用**易读易写**的纯文本格式编写文档,而且对于表格、代码、图片、公式等支持良好
- 应用广泛:网站、课程笔记/讲义、演示文稿、撰写学术论文等
- Markdown 基础语法:
- 参阅:[Markdown 中文文档](https://markdown-zh.readthedocs.io/en/latest/)、[Markdown 指南](https://www.markdown.xyz/)、[Markdown 菜鸟教程](https://www.runoob.com/markdown/md-tutorial.html)
- 标题 `#`、粗体 `** **`、斜体 `* *`、删除线 `~~ ~~`、分割线 `---`、超链接 `[]()`
- 引用 `>`、列表 `-` / `1. `、代码块
- 脚注 `[^1]` / `[^1]:`、待办事项 `[ ]` / `[x]`
- Markdown 进阶语法:
- 图片 `![]()`:本地路径、网络路径(参阅:[图床与 PicGo——让你爱上记录与分享](https://sspai.com/post/65716))
- 数学公式:行内公式 `$...$`、行间公式 `$$...$$`
- 支持 HTML 元素:`<br>`/`<hr>`/`<b></b>`/`<i></i>`/`<kbd></kbd>` 等
## 推荐的 Markdown 编辑器
<!-- _class: cols-2-64 navbar -->
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<div class=ldiv>
**VS Code**
- Visual Studio Code[下载地址](https://code.visualstudio.com/Download)
- VS Code 插件:
- 配合 Markdown:[Markdown Preview Enhanced](https://marketplace.visualstudio.com/items?itemName=shd101wyy.markdown-preview-enhanced)、[Markdown All in One](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one)
- 图床:[PicGo](https://marketplace.visualstudio.com/items?itemName=Spades.vs-picgo)
- 格式化文档:[Pangu-Markdown](https://marketplace.visualstudio.com/items?itemName=xlthu.Pangu-Markdown)
- Markdown 转 PPT:[Marp for VScode](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode)
- Markdown 转思维导图:[Markmap for VScode](https://marketplace.visualstudio.com/items?itemName=gera2ld.markmap-vscode)
- 配合 Zotero:[Citation Picker for Zotero](https://marketplace.visualstudio.com/items?itemName=mblode.zotero)、[Pandoc Citer](https://marketplace.visualstudio.com/items?itemName=notZaki.pandocciter)
</div>
<div class=rdiv>
**Obsidian**
- [Obsidian 主页](https://obsidian.md/)
- 基于 Markdown 的本地知识管理软件
- 除官方同步和发布功能外,对个人使用者完全免费
- 功能丰富、插件众多、开发社区活跃
</div>
## Marp 基本用法
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar fixedtitleB -->
<div class="div">
- 几个字总结 [Marp](https://marp.app/):使用 Markdown 创作演示文稿
- 来自 Marp 官方网页的一段话:Marp (also known as the Markdown Presentation Ecosystem) provides an intuitive experience for creating beautiful slide decks. You only have to focus on writing your story in a Markdown document.
- 在 Markdown 文件的顶部 YAML 区域,通过 `marp: true` 启动 Marp,然后即可开启侧边预览,VS Code 界面左边是代码区域,右边为预览区域
- 内容遵循 Markdown 语法,但 Marp 增加了一些内置指令,而且指令分为全局指令和[局部指令](https://marpit.marp.app/directives?id=local-directives-1),全局指令建议放置于 YAML 区,局部指令位于当前页面,不同页面通过 `---` 切分
- 推荐阅读:Marpit [官方文档](https://marpit.marp.app)及[中译版](https://caizhiyuan.gitee.io/categories/skills/20200730-marp.html#%E5%8A%9F%E8%83%BD),五分钟学会 Marp[(上)](https://www.lianxh.cn/news/97fccdca2d7a5.html)、[(下)](https://www.lianxh.cn/news/521900220dd33.html)
</div>
## Marp 基本用法
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar -->
```yaml
---
marp: true # 开启 Marp
size: 16:9 # 设定页面比例,常见有 16:9 或 4:3,默认为16:9
theme: gaia # 切换主题,内置 3 种样式的主题,可以自定义主题
paginate: true # 开启页码
headingDivider: 2 # 通过二级标题切分页面,省去手动换页的麻烦
footer: 初虹 # 设置页脚区域的内容,如果设定页眉的内容,则为 header
---
```
- 如果想让页面同时被多个级别的标题切分,比如,以二级~四级标题分割页面,可以 `headingDivider: [2,3,4]`
- 想要使得多个自定义样式渲染同一个页面,可直接将不同自定义样式以空格连接,比如:`<!-- _class: cols-2-64 fglass -->`
---
<!-- _class: lastpage -->
<!-- _footer: "" -->
###### 欢迎交流 ~
<div class="icons">
- <i class="fa-solid fa-envelope"></i>
- 邮箱:ch2099058972@163.com
- <i class="fa-brands fa-weixin"></i>
- 微信:favourhong
- <i class="fa-solid fa-house"></i>
- 公众号:虹鹄山庄
<div>
## 创作不易,buy me a coffee 🤙~
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
<br>
![#c w:300](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309240907419.png)
Binary file not shown.
File diff suppressed because one or more lines are too long
+942
View File
@@ -0,0 +1,942 @@
---
marp: true
size: 16:9
theme: am_brown
paginate: true
headingDivider:
- 2
- 3
footer: \ *初虹(虹鹄山庄)* *Awesome Marp:轻松取代 LaTeX Beamer!* *2024年1月13日(v1.3)*
created: 2025-09-09T18:22
updated: 2025-09-22T13:27
---
<!-- _class: cover_a
<!-- _header: "" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
# Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
## Awesome Marp 有什么?
<!-- _class: cols2_ol_ci fglass toc_a -->
<!-- _footer: "" -->
<!-- _header: "CONTENTS" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
## 1. 关于模板
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 1. 关于模板
- **开始之前:** 你需要知道这样几个工具,Markdown、Markdown 编辑器(VS Code 或 Obsidian)和 Marp。关于这三者是个啥,我不做详细地介绍,但在[第 55 页](#55)-[第 58 页](#58)会有一些凝练性的内容给你参考,同时我提供了不少的链接,也供你参阅。
- **为什么要开发 Awesome Marp?**
- Marp 原生仅提供 3 种主题(`default` / `gaia` / `uncover`),呈现效果一般。于是我根据自己的使用情况,边用边改造,陆续打磨了这样的一整套模板。
- **目前发布的 v1.3 有 38 个自定义样式、6 种颜色的主题**(后面有呈现效果)
- **Awesome Marp 的几个特色:**
- 支持分栏呈现、支持 Callouts(类似于 Beamer 中的定理框)、提供多种类型的封面页和目录页、可以实现导航进度栏、图片支持自定义居中/居左/居右对齐等
- 本着「开箱即用」的原则,我将本项目文件夹打包上传到了[GitHub](https://github.com/favourhong/Awesome-Marp) 和 [Gitee](https://gitee.com/favourhong/Awesome-Marp)
- 用到的工具:软件 [Visual Studio Code](https://code.visualstudio.com) 或 [Obsidian](https://obsidian.md/)、[Marp for VScode(插件)](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode)
## 1. 关于模板
- Awesome Marp 支持 38 个自定义样式,使用时需在页面指定(如 `<!-- _class: trans -->`):
| 封面页 | 目录页 | 列表 | 引用盒子 | 其他 1 | 其他 2 |
| --------- | ------- | ----------- | ----------- | ----------------------------- | --------------------------------------------------------------- |
| `cover_a` | `toc_a` | `cols-2` | `bq-black` | 过渡页面 `trans` | 图表等的标题 `caption` |
| `cover_b` | `toc_b` | `cols-2-64` | `bq-purple` | 最后一页 `lastpage` | 非嵌套无序列表的毛玻璃效果 `fglass` |
| `cover_c` | | `cols-2-73` | `bq-red` | 导航栏 `navbar` | 脚注:`footnote` |
| `cover_d` | | `cols-3` | `bq-blue` | 标题固定+无底色 `fixedtitleA` | 调节字体大小:`tinytext`/`smalltext`/<br>`largetext`/`hugetext` |
| `cover_e` | | `cols-2-46` | `bq-green` | 标题固定+有底色 `fixedtitleB` | |
| | | `cols-2-37` | | 两列有序列表 `cols2_ol_sq/ci` | |
| | | `rows-2` | | 两列无序列表 `cols_ul_sq/ci` | |
| | | `pin-3` | | 单列有序列表 `col1_ul_sq/ci` | |
## 1. 关于模板
- Awesome Marp 的主题色(6 种),可在 YAML 区切换 Theme,如 `theme: am_dark`:
| 深色 | 绿色 | 红色 | 蓝色 | 棕色 | 紫色
|---------|----------|--------|---------|----------|----|
| `am_dark` | `am_green` | `am_red` | `am_blue` | `am_brown` |`am_purple`|
## 1. 关于模板
- 如何使用:
- **搭配 VS Code**:直接使用 VS Code 打开 `Awesome-Marp` 文件夹
- 如果你想「拿来即用」,直接根据我分享的 Markdown 源码文件,对照修改就好了~
- 如果你对部分效果不满意、期望简单微调的话,目前在 `Awesome-Marp/themes` 下有 6 个 CSS 文件,这些 CSS 文件决定了 Markdown 源码的最终渲染效果,可以试着改一改~
- 如果你能够自行定制个性化 CSS 文件,渲染前,别忘在 `Awesome-Marp/.vscode/settings.json` 里加上你的 CSS 文件路径~
- **搭配 Obsidian**:安装 [Marp Slides 插件](https://github.com/samuele-cozzi/obsidian-marp-slides),并配置相应 CSS 路径
- 字体:因担心版权问题,需自行下载字体并安装,Awesome Marp 用到的字体有:
- 正文字体:`Latin Modern Math`、`方正宋刻本秀楷简体`,如果未安装,默认将使用 `Calibri` 和 `楷体`
- 标题字体:`Optima LT Medium`、`方正苏新诗柳楷简体`,如果未安装,默认将使用 `Arial` 和 `黑体`
- 脚注字体:`Charm` 和 `叶根友毛笔行书修正版`,如果未安装,默认将使用 `Calibri` 和 `楷体`
- 代码字体:`Fira Code` 和 `霞鹜文楷等宽`,如果未安装,默认将使用 `Consolas` 和 `华文中宋`
## 1. 关于模板:更新日志
- [Awesome Marp v1.0:我开发了一整套 Marp 主题,Markdown 转换的 PPT 也可以很好看!](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486787&idx=1&sn=2652ddae81f50240844cb652780912e1&chksm=c13ff94bf648705da1ba986b91265e3ff018acaffcfa60d7807a81be22176005e7a2b4483627&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.1:标题行不随正文浮动,这下更像 Beamer 了!](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486800&idx=1&sn=527348e242576079e4bd6cd1823c823a&chksm=c13ff958f648704e40a202db6ad5fa215ef4c189d66403e161d6ace9828406a8747ac755684f&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.2:增加脚注、调节字体大小等样式~](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486825&idx=1&sn=56d632ce164831438ec87c1b20ed4c4c&chksm=c13ff961f64870774f069ab816340783d8f54fd6b89363b8d9412c593efc640851ce9edd8833&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.3:几处小更新~](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486869&idx=1&sn=fcc377ff6a5930436e5078a09d53f0ab&chksm=c13ff99df648708b89bafba030b27909d0022279e26da723ca54a1666fe55f50a4230f050662&scene=178&cur_album_id=3132459596339757070#rd)
## 下面让我们看看效果吧 ~
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 2. 封面页
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 2. 封面页
- 大标题:采用一级标题 `# ` (如:`# Awesome Marp:自定义 Marp 主题`)
- 副标题:采用六级标题 `###### ` (如:`###### 打造简便又不失个性的演示文稿`)
- 本套模板提供 5 种封面页样式,使用时需要在页面中设定局部指令,如:`<!-- _class: cover_a -->`
- `cover_a`:[第 1 种](#1)
- `cover_b`:[第 2 种](#12)
- `cover_c`:预留 header 可设定学校 logo,footer 可设定校训 [第 3 种](#13)
- `cover_d`:只预留了 footer 设定校训 [第 4 种](#14)
- `cover_e`:预留 header 设定学校 logo,footer 设定学校 logo 和学校名称[第 5 种](#15)
- 如果已经设定了全局 footer、header 或页码,但又不期望在封面页中出现,可以 `<!-- _footer: "" -->` / `<!-- _header: "" -->` / `<!-- _paginate: "" -->` 分别将其局部隐藏起来
- 当标题文字超过页面宽度会溢出换行,这里可以使用 `<!-- fit -->` 根据页面宽度自动调整文字大小
---
<!-- _class: cover_b -->
<!-- _header: "" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
# Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_c -->
<!-- _paginate: "" -->
<!-- _footer: 厚德博学 经济匡时 -->
<!-- _header: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291116463.png) -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_d -->
<!-- _paginate: "" -->
<!-- _footer: "厚德博学 经济匡时" -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_e -->
<!-- _paginate: "" -->
<!-- _footer: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291116463.png) -->
<!-- _header: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291053273.png) -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
## 3. 目录页
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 3. 目录页
- Awesome Marp 提供了至少 2 种目录页样式,使用时同样需要设定局部样式
- `toc_a`:需要将 header 的内容设定为 `CONTENTS`,即 `<!-- _header: "CONTENTS" -->`
- `toc_b`:需要将 header 的内容设定为 `目录<br>CONTENTS<br>你的LOGO地址`,即 `<!-- _header: 目录<br>CONTENTS<br>![](./logo.png)-->`
- 提供的几种分栏列表样式,也可以作为目录页使用,如 `<!-- _class: cols2_ol_ci fglass -->`(效果见[这里](#32))
- 类似地,如果已经定义了全局 footer 或页码,可以使用 `<!-- _footer: "" -->` / `<!-- _paginate: "" -->` 分别将其局部隐藏起来
- 目录页样式:[第 1 种](#2)、[第 2 种](#18)和[第 3 种](#19)
---
<!-- _class: toc_a -->
<!-- _header: "CONTENTS" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
---
<!-- _header: 目录<br>CONTENTS<br>![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291053273.png)-->
<!-- _class: toc_b -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
## 4. 页面分栏与列表分列
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 4.1 页面分栏与列表分列:页面分栏
- Awesome Marp 提供了 8 种页面分栏方式,分别为:
- `cols-2`:[两列分栏,五五平分](#23)
- `cols-2-64`:[两列分栏,六四分](#24)
- `cols-2-73`:[两列分栏,七三分](#25)
- `cols-2-46`:[两列分栏,四六分](#26)
- `cols-2-37`:[两列分栏,三七分](#27)
- `cols-3`:[三列分栏,平分](#28)
- `rows-2`:[两行分栏](#29)
- `pin-3`:[品字型分栏](#30)
- 如果某一栏为图片,可以将 `class=ldiv` 换成 `class=limg`,这样能够实现图片的垂直居中对齐呢(`class=ldiv` 为居上对齐)
## 4.1 页面分栏与列表分列:页面分栏
- 以 `<!-- _class: cols-2 -->` 为例,Markdown 的源码为:
```markdown
<!-- _class: cols-2 -->
<div class=ldiv>
第一列(左侧栏)的内容在这里
内容可以是普通纯文本,可以是列表,也可以是引用块、链接、图片等
</div>
<div class=rdiv>
第二列(右侧栏)的内容在这里
</div>
```
- 如果是分三栏(`<!-- _class: cols-3 -->`),还需要再增加 `<div class="mdiv"></div>` 标签
## 《荷塘月色》(两栏五五分)
<!-- _class: cols-2 -->
<div class=ldiv>
曲曲折折的荷塘上面,弥望的是田田的叶子。叶子出水很高,像亭亭的舞女的裙。
层层的叶子中间,零星地点缀着些白花,有袅娜地开着的,有羞涩地打着朵儿的;正如一粒粒的明珠,又如碧天里的星星,又如刚出浴的美人。
微风过处,送来缕缕清香,仿佛远处高楼上渺茫的歌声似的。这时候叶子与花也有一丝的颤动,像闪电般,霎时传过荷塘的那边去了。
叶子本是肩并肩密密地挨着,这便宛然有了一道凝碧的波痕。叶子底下是脉脉的流水,遮住了,不能见一些颜色;而叶子却更见风致了。
—— 朱自清《荷塘月色》 [返回](#21)
</div>
<div class=rimg>
<!-- ![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221014499.png) -->
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221630151.png)
</div>
## 《春》(两栏六四分)
<!-- _class: cols-2-64 -->
<div class=limg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201217248.png)
</div>
<div class=rdiv>
盼望着,盼望着,东风来了,春天的脚步近了。
一切都像刚睡醒的样子,欣欣然张开了眼。山朗润起来了,水涨起来了,太阳的脸红起来了。
小草偷偷地从土里钻出来,嫩嫩的,绿绿的。园子里,田野里,瞧去,一大片一大片满是的。坐着,躺着,打两个滚,踢几脚球,赛几趟跑,捉几回迷藏。风轻悄悄的,草软绵绵的。
—— 朱自清《春》
[返回](#21)
</div>
## 经典散文诗篇(两栏七三分)
<!-- _class: cols-2-73 -->
<div class=limg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221010523.png)
</div>
<div class=rdiv>
经典的散文诗篇有:
- 朱自清:《荷塘月色》
- 林清玄:《月到天心》
- 郁达夫:《古都的秋》
- 张爱玲:《花落的声音》
- 余光中:《听听那冷雨》
- 张抗抗:《牡丹的拒绝》
- 丰子恺:《杨柳》
- 周作人:《乌篷船》
- 郑振铎:《石湖》
- 梁实秋:《雅舍》
[返回](#21)
</div>
## 《春》(两栏四六分)
<!-- _class: cols-2-46 -->
<div class=ldiv>
盼望着,盼望着,东风来了,春天的脚步近了。
一切都像刚睡醒的样子,欣欣然张开了眼。山朗润起来了,水涨起来了,太阳的脸红起来了。
小草偷偷地从土里钻出来,嫩嫩的,绿绿的。园子里,田野里,瞧去,一大片一大片满是的。坐着,躺着,打两个滚,踢几脚球,赛几趟跑,捉几回迷藏。风轻悄悄的,草软绵绵的。
—— 朱自清《春》
[返回](#21)
</div>
<div class=rimg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201217248.png)
</div>
## 经典散文诗篇(两栏三七分)
<!-- _class: cols-2-37 -->
<div class=ldiv>
经典的散文诗篇有:
- 朱自清:《荷塘月色》
- 林清玄:《月到天心》
- 郁达夫:《古都的秋》
- 张爱玲:《花落的声音》
- 余光中:《听听那冷雨》
- 张抗抗:《牡丹的拒绝》
- 丰子恺:《杨柳》
- 周作人:《乌篷船》
- 郑振铎:《石湖》
- 梁实秋:《雅舍》
[返回](#21)
</div>
<div class=rimg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221010523.png)
</div>
## 夏与秋(三栏三平分)
<!-- _class: cols-3 -->
<div class=ldiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201206630.png)
</div>
<div class=mdiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201151809.png)
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201158036.png)
</div>
<div class=rdiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201154535.png)
[返回](#21)
</div>
## 高山与沙漠(两行分栏)
<!-- _class: rows-2 -->
<div class="timg">
![#c h:250](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131736186.png)
</div>
<div class="bimg">
![#c h:260](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131737821.png)
</div>
## 《宇宙的奥秘》(品字型分栏)
<!-- _class: pin-3 -->
<div class="tdiv">
> 四百年前,两位截然不同的科学家突破了当时已知世界的边界。1609 年在威尼斯,伽利略・伽利雷透过望远镜观察星辰,并制作仪器和进行实验。在布拉格,科班出身的神学家约翰内斯・开普勒发现了行星运动定律,奠定了近代天体物理学的基础,并思考着宇宙的宏伟构造。托马斯・德・帕多瓦以至今较少受到关注却扣人心弦的通信往来为基础,讲述了这两位类型如此迥异的学者之间不对等的关系,以及他们如何在同样的时刻却以各自的方式探索星辰的奥秘。在彼此的鉴照下,他们的远见与固执、睿智与无知得以呈现。这是一部介绍新科学的崛起以及近代来临之际的巨大变革的作品。 ——《宇宙的奥妙》
</div>
<div class="limg">
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131712626.png)
</div>
<div class="rimg">
![#c h:260](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131713779.png)
</div>
## 4.2 页面分栏与列表分列:列表分列
Awesome Marp v1.3 提供了 6 种列表分列的方式,分别为:
- `cols2_ol_sq`:呈现效果为[有序列表 + 方形序号](#32)
- `cols2_ol_ci`:呈现效果为[有序列表 + 圆形序号](#33)
- `cols2_ul_sq`:呈现效果为[无序列表 + 方形序号](#34)
- `cols2_ul_ci`:呈现效果为[无序列表 + 圆形序号](#35)
- `col1_ul_sq`:呈现效果为[有序列表 + 方形序号](#36)
- `col1_ul_ci`:呈现效应为[有序列表 + 圆形序号](#37)
## 《微观经济学:现代观点》
<!-- _class: cols2_ol_sq fglass -->
渲染效果为**有序列表+方形序号**
自定义样式为:`<!-- _class: cols2_ol_sq fglass -->`
- 偏好和效用
- 预算约束和消费者的最优选择
- 需求函数
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 博弈论
- 交换经济与生产经济
- 外部性与公共品
- 不确定性、期望效用和不对称信息
[返回](#28)
## 《微观经济学:现代观点》
<!-- _class: cols2_ol_ci fglass -->
渲染效果为**有序列表+圆形序号**
自定义样式为:`<!-- _class: cols2_ol_ci fglass -->`
- 偏好和效用
- 预算约束和消费者的最优选择
- 需求函数
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 博弈论
- 交换经济与生产经济
- 外部性与公共品
- 不确定性、期望效用和不对称信息
[返回](#28)
## 《置身事内》
<!-- _class: cols2_ul_sq fglass -->
渲染效果为**无序列表+方形序号**
自定义样式为:`<!-- _class: cols2_ul_sq fglass -->`
- 第一章:地方政府的权力与事务
- 第二章:财税与政府行为
- 第三章:政府投融资与债务
- 第四章:工业化中的政府角色
- 第五章:城市化与不平衡
- 第六章:债务与风险
- 第七章:国内国际失衡
- 第八章:政府与经济发展
[返回](#28)
## 《置身事内》
<!-- _class: cols2_ul_ci fglass -->
渲染效果为**无序列表+圆形序号**
自定义样式为:`<!-- _class: cols2_ul_ci fglass -->`
- 第一章:地方政府的权力与事务
- 第二章:财税与政府行为
- 第三章:政府投融资与债务
- 第四章:工业化中的政府角色
- 第五章:城市化与不平衡
- 第六章:债务与风险
- 第七章:国内国际失衡
- 第八章:政府与经济发展
[返回](#28)
## 《微观经济学:现代观点》
<!-- _class: col1_ol_sq fglass -->
渲染效果为**单列+有序列表+方形序号**
自定义样式为:`<!-- _class: col1_ul_sq fglass -->`
- 预算约束和消费者的最优选择
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 交换经济与生产经济
- 不确定性、期望效用和不对称信息
## 《微观经济学:现代观点》
<!-- _class: col1_ol_ci fglass -->
渲染效果为**单列+有序列表+圆形序号**
自定义样式为:`<!-- _class: col1_ul_ci fglass -->`
- 预算约束和消费者的最优选择
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 交换经济与生产经济
- 不确定性、期望效用和不对称信息
## 5. 引用、链接和 Callouts
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 5. 引用、链接和 Callouts
- 引用的呈现效果为:
> 合成控制法 (Synthetic Control Method) 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。
- 链接的呈现效果:
- [经管数据清洗与 Stata 实战:三大地级市数据库和 CSMAR 上市公司数据](https://mp.weixin.qq.com/s/D0cYVPJJsNiu61GcYwV6cg)
- [Stata 基础:从论文文件夹体系的建立说起](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486489&idx=1&sn=2eb51e85a01541c7a552a9434e087512&scene=21#wechat_redirect)
- Callouts 是 Awesome Marp 提供的自定义的样式,有 5 种颜色可选:
- [紫色](#40):`bq-purple`
- [蓝色](#41):`bq-blue`
- [绿色](#42):`bq-green`
- [红色](#43):`bq-red`
- [黑色](#44):`bq-black`
## 5. 引用、链接和引用盒子
<!-- _class: bq-purple -->
- 自定义样式为:`<!-- _class: bq-purple -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-blue -->
- 自定义样式为:`<!-- _class: bq-blue -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-green -->
- 自定义样式为:`<!-- _class: bq-green -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-red -->
- 自定义样式为:`<!-- _class: bq-red -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-black -->
- 自定义样式为:`<!-- _class: bq-black -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 6. 导航栏
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 6. 导航栏
<!-- _class: navbar -->
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* **导航栏** *基础知识*-->
- 一句题外话:打造 Awesome Marp 模板的最早初衷就是来自几位公众号粉丝朋友的询问,「Marp 是否也能实现想 Beamer 那样的顶部导航栏?」为了实现导航栏的效果,我又多学了一些 CSS 的知识,这套模板才得以成型
- 自定义样式为 `navbar`:`<!-- _class: navbar -->`
- 导航栏修改自 header,最前面必须加入 `\ `
- 当前活动标题,使用粗体 `**粗体**`
- 其余非活动标题,使用斜体 `*斜体*`
- 如果左侧有文字,需要使用斜粗体 `***粗斜体***`
- 默认根据内容自动分配间距,如果希望右对齐,可以手动增加空格的方式来推动右对齐
## 6. 导航栏
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* **导航栏** *基础知识*-->
<!-- _class: navbar -->
这张页面的部分 Markdown 源码:
```markdown
<!-- _class: navbar -->
<!-- _header: \ ***虹鹄山庄***
- 自定义样式为 `navbar`:`<!-- _class: navbar -->`
- 导航栏修改自 header,最前面必须加入 `\ `
- 当前活动标题:使用粗体 `**粗体**`
- 其余非活动标题:使用斜体 `*斜体*`
- 如果左侧有文字:使用斜粗体 `***粗斜体***`
- 默认根据内容自动分配间距,如果希望右对齐,可以手动增加空格的方式来推动右对齐
```
## 7. 其他自定义样式
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 7.1 固定标题行:更像 Beamer 了(`fixedtitleA`)
<!-- _class: fixedtitleA -->
- 自定义样式:`<!-- _class: fixedtitleA -->`
- 使当前页面的标题栏固定在顶部,而非随着内容的多少浮动
- 同时,页面内容也会从顶部起笔,而非垂直方向上居中显示
## 7.1 固定标题行:更像 Beamer 了(`fixedtitleB`)
<!-- _class: fixedtitleB -->
<div class="div">
- 自定义样式:`<!-- _class: fixedtitleB -->`
- `fixedtitleB` 相比于 `fixedtitleA`,标题增加了底色色块,同时缩小了标题大小
- 其余效果与 `fixedtitleA` 相同
- 但是页面正文内容需要包裹在 `<div class="div'></div>` 标签中
</div>
---
<!-- _class: footnote -->
<div class="tdiv">
#### 7.2 脚注的自定义样式:`footnote`
使用方法:
- 自定义样式:`<!-- _class: footnote -->`
- 页面除脚注外的其他内容,写在 `<div class = "tdiv"></div>`
- 页面的脚注内容,写在 `<div class = "bdiv"></div>`
举个例子,展示一下显示效果:
- 一方面,经济金融化程度的加深,使得金融部门能够凭借资本跨期配置提前抽取其他部门的未来价值,从而扩大金融和非金融部门之间的外部收入差距$^1$。另一方面,经济金融化不断增加企业股东权力,促使企业更加追求股东价值最大化,这一导向将弱化普通劳动者阶层的议价能力,食利者阶层的财产性收入增加必然会挤压劳动收入份额,从而扩大了内部收入差距$^2$。
</div>
<div class="bdiv">
1 张甜迪. 金融化对中国金融、非金融行业收入差距的影响[J]. 经济问题, 2015(11): 40-46.
2 Hein E. Finance-dominated capitalism and re-distribution of income: a Kaleckian perspective[J]. Cambridge Journal of Economics, 2015, 39(3): 907-934.
</div>
## 7.3 调节文字大小的自定义样式
<!-- _class: largetext -->
对于字体大小的调节,直接修改 CSS 文件应该很方便的。但有小伙伴提出,“希望可以增加字体调节的自定义样式”,于是目前提供了四种微调样式:
- 自定义样式 1:`<!-- _class: tinytext -->` (是默认字体大小的 0.8 倍)
- 自定义样式 2:`<!-- _class: smalltext -->` (是默认字体大小的 0.9 倍)
- 自定义样式 3:`<!-- _class: largetext -->` (是默认字体大小的 1.15 倍)
- 自定义样式 4:`<!-- _class: hugetext -->` (是默认字体大小的 1.3 倍)
比如,本页面采用的自定义样式为 `largetext`
## 7.4 图表标题的自定义样式:`caption`
<!-- _class: caption -->
- 通过 `<div class="caption">宇宙的奥妙</div>` 来定义图表的标题
![#c h:380](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131712626.png)
<div class="caption">
宇宙的奥妙
</div>
## 需要知道的基础知识……
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## Markdown 概览
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar -->
- Markdown 是一种**极轻量**的文本标记语言,允许人们使用**易读易写**的纯文本格式编写文档,而且对于表格、代码、图片、公式等支持良好
- 应用广泛:网站、课程笔记/讲义、演示文稿、撰写学术论文等
- Markdown 基础语法:
- 参阅:[Markdown 中文文档](https://markdown-zh.readthedocs.io/en/latest/)、[Markdown 指南](https://www.markdown.xyz/)、[Markdown 菜鸟教程](https://www.runoob.com/markdown/md-tutorial.html)
- 标题 `#`、粗体 `** **`、斜体 `* *`、删除线 `~~ ~~`、分割线 `---`、超链接 `[]()`
- 引用 `>`、列表 `-` / `1. `、代码块
- 脚注 `[^1]` / `[^1]:`、待办事项 `[ ]` / `[x]`
- Markdown 进阶语法:
- 图片 `![]()`:本地路径、网络路径(参阅:[图床与 PicGo——让你爱上记录与分享](https://sspai.com/post/65716))
- 数学公式:行内公式 `$...$`、行间公式 `$$...$$`
- 支持 HTML 元素:`<br>`/`<hr>`/`<b></b>`/`<i></i>`/`<kbd></kbd>` 等
## 推荐的 Markdown 编辑器
<!-- _class: cols-2-64 navbar -->
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<div class=ldiv>
**VS Code**
- Visual Studio Code[下载地址](https://code.visualstudio.com/Download)
- VS Code 插件:
- 配合 Markdown:[Markdown Preview Enhanced](https://marketplace.visualstudio.com/items?itemName=shd101wyy.markdown-preview-enhanced)、[Markdown All in One](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one)
- 图床:[PicGo](https://marketplace.visualstudio.com/items?itemName=Spades.vs-picgo)
- 格式化文档:[Pangu-Markdown](https://marketplace.visualstudio.com/items?itemName=xlthu.Pangu-Markdown)
- Markdown 转 PPT:[Marp for VScode](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode)
- Markdown 转思维导图:[Markmap for VScode](https://marketplace.visualstudio.com/items?itemName=gera2ld.markmap-vscode)
- 配合 Zotero:[Citation Picker for Zotero](https://marketplace.visualstudio.com/items?itemName=mblode.zotero)、[Pandoc Citer](https://marketplace.visualstudio.com/items?itemName=notZaki.pandocciter)
</div>
<div class=rdiv>
**Obsidian**
- [Obsidian 主页](https://obsidian.md/)
- 基于 Markdown 的本地知识管理软件
- 除官方同步和发布功能外,对个人使用者完全免费
- 功能丰富、插件众多、开发社区活跃
</div>
## Marp 基本用法
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar fixedtitleB -->
<div class="div">
- 几个字总结 [Marp](https://marp.app/):使用 Markdown 创作演示文稿
- 来自 Marp 官方网页的一段话:Marp (also known as the Markdown Presentation Ecosystem) provides an intuitive experience for creating beautiful slide decks. You only have to focus on writing your story in a Markdown document.
- 在 Markdown 文件的顶部 YAML 区域,通过 `marp: true` 启动 Marp,然后即可开启侧边预览,VS Code 界面左边是代码区域,右边为预览区域
- 内容遵循 Markdown 语法,但 Marp 增加了一些内置指令,而且指令分为全局指令和[局部指令](https://marpit.marp.app/directives?id=local-directives-1),全局指令建议放置于 YAML 区,局部指令位于当前页面,不同页面通过 `---` 切分
- 推荐阅读:Marpit [官方文档](https://marpit.marp.app)及[中译版](https://caizhiyuan.gitee.io/categories/skills/20200730-marp.html#%E5%8A%9F%E8%83%BD),五分钟学会 Marp[(上)](https://www.lianxh.cn/news/97fccdca2d7a5.html)、[(下)](https://www.lianxh.cn/news/521900220dd33.html)
</div>
## Marp 基本用法
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar -->
```yaml
---
marp: true # 开启 Marp
size: 16:9 # 设定页面比例,常见有 16:9 或 4:3,默认为16:9
theme: gaia # 切换主题,内置 3 种样式的主题,可以自定义主题
paginate: true # 开启页码
headingDivider: 2 # 通过二级标题切分页面,省去手动换页的麻烦
footer: 初虹 # 设置页脚区域的内容,如果设定页眉的内容,则为 header
---
```
- 如果想让页面同时被多个级别的标题切分,比如,以二级~四级标题分割页面,可以 `headingDivider: [2,3,4]`
- 想要使得多个自定义样式渲染同一个页面,可直接将不同自定义样式以空格连接,比如:`<!-- _class: cols-2-64 fglass -->`
---
<!-- _class: lastpage -->
<!-- _footer: "" -->
###### 欢迎交流 ~
<div class="icons">
- <i class="fa-solid fa-envelope"></i>
- 邮箱:ch2099058972@163.com
- <i class="fa-brands fa-weixin"></i>
- 微信:favourhong
- <i class="fa-solid fa-house"></i>
- 公众号:虹鹄山庄
<div>
## 创作不易,buy me a coffee 🤙~
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
<br>
![#c w:300](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309240907419.png)
Binary file not shown.
File diff suppressed because one or more lines are too long
+942
View File
@@ -0,0 +1,942 @@
---
marp: true
size: 16:9
theme: am_dark
paginate: true
headingDivider:
- 2
- 3
footer: \ *初虹(虹鹄山庄)* *Awesome Marp:轻松取代 LaTeX Beamer!* *2024年1月13日(v1.3)*
created: 2025-09-09T18:22
updated: 2025-09-22T13:27
---
<!-- _class: cover_a
<!-- _header: "" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
# Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
## Awesome Marp 有什么?
<!-- _class: cols2_ol_ci fglass toc_a -->
<!-- _footer: "" -->
<!-- _header: "CONTENTS" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
## 1. 关于模板
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 1. 关于模板
- **开始之前:** 你需要知道这样几个工具,Markdown、Markdown 编辑器(VS Code 或 Obsidian)和 Marp。关于这三者是个啥,我不做详细地介绍,但在[第 55 页](#55)-[第 58 页](#58)会有一些凝练性的内容给你参考,同时我提供了不少的链接,也供你参阅。
- **为什么要开发 Awesome Marp?**
- Marp 原生仅提供 3 种主题(`default` / `gaia` / `uncover`),呈现效果一般。于是我根据自己的使用情况,边用边改造,陆续打磨了这样的一整套模板。
- **目前发布的 v1.3 有 38 个自定义样式、6 种颜色的主题**(后面有呈现效果)
- **Awesome Marp 的几个特色:**
- 支持分栏呈现、支持 Callouts(类似于 Beamer 中的定理框)、提供多种类型的封面页和目录页、可以实现导航进度栏、图片支持自定义居中/居左/居右对齐等
- 本着「开箱即用」的原则,我将本项目文件夹打包上传到了[GitHub](https://github.com/favourhong/Awesome-Marp) 和 [Gitee](https://gitee.com/favourhong/Awesome-Marp)
- 用到的工具:软件 [Visual Studio Code](https://code.visualstudio.com) 或 [Obsidian](https://obsidian.md/)、[Marp for VScode(插件)](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode)
## 1. 关于模板
- Awesome Marp 支持 38 个自定义样式,使用时需在页面指定(如 `<!-- _class: trans -->`):
| 封面页 | 目录页 | 列表 | 引用盒子 | 其他 1 | 其他 2 |
| --------- | ------- | ----------- | ----------- | ----------------------------- | --------------------------------------------------------------- |
| `cover_a` | `toc_a` | `cols-2` | `bq-black` | 过渡页面 `trans` | 图表等的标题 `caption` |
| `cover_b` | `toc_b` | `cols-2-64` | `bq-purple` | 最后一页 `lastpage` | 非嵌套无序列表的毛玻璃效果 `fglass` |
| `cover_c` | | `cols-2-73` | `bq-red` | 导航栏 `navbar` | 脚注:`footnote` |
| `cover_d` | | `cols-3` | `bq-blue` | 标题固定+无底色 `fixedtitleA` | 调节字体大小:`tinytext`/`smalltext`/<br>`largetext`/`hugetext` |
| `cover_e` | | `cols-2-46` | `bq-green` | 标题固定+有底色 `fixedtitleB` | |
| | | `cols-2-37` | | 两列有序列表 `cols2_ol_sq/ci` | |
| | | `rows-2` | | 两列无序列表 `cols_ul_sq/ci` | |
| | | `pin-3` | | 单列有序列表 `col1_ul_sq/ci` | |
## 1. 关于模板
- Awesome Marp 的主题色(6 种),可在 YAML 区切换 Theme,如 `theme: am_dark`:
| 深色 | 绿色 | 红色 | 蓝色 | 棕色 | 紫色
|---------|----------|--------|---------|----------|----|
| `am_dark` | `am_green` | `am_red` | `am_blue` | `am_brown` |`am_purple`|
## 1. 关于模板
- 如何使用:
- **搭配 VS Code**:直接使用 VS Code 打开 `Awesome-Marp` 文件夹
- 如果你想「拿来即用」,直接根据我分享的 Markdown 源码文件,对照修改就好了~
- 如果你对部分效果不满意、期望简单微调的话,目前在 `Awesome-Marp/themes` 下有 6 个 CSS 文件,这些 CSS 文件决定了 Markdown 源码的最终渲染效果,可以试着改一改~
- 如果你能够自行定制个性化 CSS 文件,渲染前,别忘在 `Awesome-Marp/.vscode/settings.json` 里加上你的 CSS 文件路径~
- **搭配 Obsidian**:安装 [Marp Slides 插件](https://github.com/samuele-cozzi/obsidian-marp-slides),并配置相应 CSS 路径
- 字体:因担心版权问题,需自行下载字体并安装,Awesome Marp 用到的字体有:
- 正文字体:`Latin Modern Math`、`方正宋刻本秀楷简体`,如果未安装,默认将使用 `Calibri` 和 `楷体`
- 标题字体:`Optima LT Medium`、`方正苏新诗柳楷简体`,如果未安装,默认将使用 `Arial` 和 `黑体`
- 脚注字体:`Charm` 和 `叶根友毛笔行书修正版`,如果未安装,默认将使用 `Calibri` 和 `楷体`
- 代码字体:`Fira Code` 和 `霞鹜文楷等宽`,如果未安装,默认将使用 `Consolas` 和 `华文中宋`
## 1. 关于模板:更新日志
- [Awesome Marp v1.0:我开发了一整套 Marp 主题,Markdown 转换的 PPT 也可以很好看!](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486787&idx=1&sn=2652ddae81f50240844cb652780912e1&chksm=c13ff94bf648705da1ba986b91265e3ff018acaffcfa60d7807a81be22176005e7a2b4483627&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.1:标题行不随正文浮动,这下更像 Beamer 了!](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486800&idx=1&sn=527348e242576079e4bd6cd1823c823a&chksm=c13ff958f648704e40a202db6ad5fa215ef4c189d66403e161d6ace9828406a8747ac755684f&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.2:增加脚注、调节字体大小等样式~](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486825&idx=1&sn=56d632ce164831438ec87c1b20ed4c4c&chksm=c13ff961f64870774f069ab816340783d8f54fd6b89363b8d9412c593efc640851ce9edd8833&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.3:几处小更新~](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486869&idx=1&sn=fcc377ff6a5930436e5078a09d53f0ab&chksm=c13ff99df648708b89bafba030b27909d0022279e26da723ca54a1666fe55f50a4230f050662&scene=178&cur_album_id=3132459596339757070#rd)
## 下面让我们看看效果吧 ~
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 2. 封面页
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 2. 封面页
- 大标题:采用一级标题 `# ` (如:`# Awesome Marp:自定义 Marp 主题`)
- 副标题:采用六级标题 `###### ` (如:`###### 打造简便又不失个性的演示文稿`)
- 本套模板提供 5 种封面页样式,使用时需要在页面中设定局部指令,如:`<!-- _class: cover_a -->`
- `cover_a`:[第 1 种](#1)
- `cover_b`:[第 2 种](#12)
- `cover_c`:预留 header 可设定学校 logo,footer 可设定校训 [第 3 种](#13)
- `cover_d`:只预留了 footer 设定校训 [第 4 种](#14)
- `cover_e`:预留 header 设定学校 logo,footer 设定学校 logo 和学校名称[第 5 种](#15)
- 如果已经设定了全局 footer、header 或页码,但又不期望在封面页中出现,可以 `<!-- _footer: "" -->` / `<!-- _header: "" -->` / `<!-- _paginate: "" -->` 分别将其局部隐藏起来
- 当标题文字超过页面宽度会溢出换行,这里可以使用 `<!-- fit -->` 根据页面宽度自动调整文字大小
---
<!-- _class: cover_b -->
<!-- _header: "" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
# Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_c -->
<!-- _paginate: "" -->
<!-- _footer: 厚德博学 经济匡时 -->
<!-- _header: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291116463.png) -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_d -->
<!-- _paginate: "" -->
<!-- _footer: "厚德博学 经济匡时" -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_e -->
<!-- _paginate: "" -->
<!-- _footer: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291116463.png) -->
<!-- _header: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291053273.png) -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
## 3. 目录页
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 3. 目录页
- Awesome Marp 提供了至少 2 种目录页样式,使用时同样需要设定局部样式
- `toc_a`:需要将 header 的内容设定为 `CONTENTS`,即 `<!-- _header: "CONTENTS" -->`
- `toc_b`:需要将 header 的内容设定为 `目录<br>CONTENTS<br>你的LOGO地址`,即 `<!-- _header: 目录<br>CONTENTS<br>![](./logo.png)-->`
- 提供的几种分栏列表样式,也可以作为目录页使用,如 `<!-- _class: cols2_ol_ci fglass -->`(效果见[这里](#32))
- 类似地,如果已经定义了全局 footer 或页码,可以使用 `<!-- _footer: "" -->` / `<!-- _paginate: "" -->` 分别将其局部隐藏起来
- 目录页样式:[第 1 种](#2)、[第 2 种](#18)和[第 3 种](#19)
---
<!-- _class: toc_a -->
<!-- _header: "CONTENTS" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
---
<!-- _header: 目录<br>CONTENTS<br>![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291053273.png)-->
<!-- _class: toc_b -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
## 4. 页面分栏与列表分列
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 4.1 页面分栏与列表分列:页面分栏
- Awesome Marp 提供了 8 种页面分栏方式,分别为:
- `cols-2`:[两列分栏,五五平分](#23)
- `cols-2-64`:[两列分栏,六四分](#24)
- `cols-2-73`:[两列分栏,七三分](#25)
- `cols-2-46`:[两列分栏,四六分](#26)
- `cols-2-37`:[两列分栏,三七分](#27)
- `cols-3`:[三列分栏,平分](#28)
- `rows-2`:[两行分栏](#29)
- `pin-3`:[品字型分栏](#30)
- 如果某一栏为图片,可以将 `class=ldiv` 换成 `class=limg`,这样能够实现图片的垂直居中对齐呢(`class=ldiv` 为居上对齐)
## 4.1 页面分栏与列表分列:页面分栏
- 以 `<!-- _class: cols-2 -->` 为例,Markdown 的源码为:
```markdown
<!-- _class: cols-2 -->
<div class=ldiv>
第一列(左侧栏)的内容在这里
内容可以是普通纯文本,可以是列表,也可以是引用块、链接、图片等
</div>
<div class=rdiv>
第二列(右侧栏)的内容在这里
</div>
```
- 如果是分三栏(`<!-- _class: cols-3 -->`),还需要再增加 `<div class="mdiv"></div>` 标签
## 《荷塘月色》(两栏五五分)
<!-- _class: cols-2 -->
<div class=ldiv>
曲曲折折的荷塘上面,弥望的是田田的叶子。叶子出水很高,像亭亭的舞女的裙。
层层的叶子中间,零星地点缀着些白花,有袅娜地开着的,有羞涩地打着朵儿的;正如一粒粒的明珠,又如碧天里的星星,又如刚出浴的美人。
微风过处,送来缕缕清香,仿佛远处高楼上渺茫的歌声似的。这时候叶子与花也有一丝的颤动,像闪电般,霎时传过荷塘的那边去了。
叶子本是肩并肩密密地挨着,这便宛然有了一道凝碧的波痕。叶子底下是脉脉的流水,遮住了,不能见一些颜色;而叶子却更见风致了。
—— 朱自清《荷塘月色》 [返回](#21)
</div>
<div class=rimg>
<!-- ![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221014499.png) -->
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221630151.png)
</div>
## 《春》(两栏六四分)
<!-- _class: cols-2-64 -->
<div class=limg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201217248.png)
</div>
<div class=rdiv>
盼望着,盼望着,东风来了,春天的脚步近了。
一切都像刚睡醒的样子,欣欣然张开了眼。山朗润起来了,水涨起来了,太阳的脸红起来了。
小草偷偷地从土里钻出来,嫩嫩的,绿绿的。园子里,田野里,瞧去,一大片一大片满是的。坐着,躺着,打两个滚,踢几脚球,赛几趟跑,捉几回迷藏。风轻悄悄的,草软绵绵的。
—— 朱自清《春》
[返回](#21)
</div>
## 经典散文诗篇(两栏七三分)
<!-- _class: cols-2-73 -->
<div class=limg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221010523.png)
</div>
<div class=rdiv>
经典的散文诗篇有:
- 朱自清:《荷塘月色》
- 林清玄:《月到天心》
- 郁达夫:《古都的秋》
- 张爱玲:《花落的声音》
- 余光中:《听听那冷雨》
- 张抗抗:《牡丹的拒绝》
- 丰子恺:《杨柳》
- 周作人:《乌篷船》
- 郑振铎:《石湖》
- 梁实秋:《雅舍》
[返回](#21)
</div>
## 《春》(两栏四六分)
<!-- _class: cols-2-46 -->
<div class=ldiv>
盼望着,盼望着,东风来了,春天的脚步近了。
一切都像刚睡醒的样子,欣欣然张开了眼。山朗润起来了,水涨起来了,太阳的脸红起来了。
小草偷偷地从土里钻出来,嫩嫩的,绿绿的。园子里,田野里,瞧去,一大片一大片满是的。坐着,躺着,打两个滚,踢几脚球,赛几趟跑,捉几回迷藏。风轻悄悄的,草软绵绵的。
—— 朱自清《春》
[返回](#21)
</div>
<div class=rimg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201217248.png)
</div>
## 经典散文诗篇(两栏三七分)
<!-- _class: cols-2-37 -->
<div class=ldiv>
经典的散文诗篇有:
- 朱自清:《荷塘月色》
- 林清玄:《月到天心》
- 郁达夫:《古都的秋》
- 张爱玲:《花落的声音》
- 余光中:《听听那冷雨》
- 张抗抗:《牡丹的拒绝》
- 丰子恺:《杨柳》
- 周作人:《乌篷船》
- 郑振铎:《石湖》
- 梁实秋:《雅舍》
[返回](#21)
</div>
<div class=rimg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221010523.png)
</div>
## 夏与秋(三栏三平分)
<!-- _class: cols-3 -->
<div class=ldiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201206630.png)
</div>
<div class=mdiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201151809.png)
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201158036.png)
</div>
<div class=rdiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201154535.png)
[返回](#21)
</div>
## 高山与沙漠(两行分栏)
<!-- _class: rows-2 -->
<div class="timg">
![#c h:250](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131736186.png)
</div>
<div class="bimg">
![#c h:260](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131737821.png)
</div>
## 《宇宙的奥秘》(品字型分栏)
<!-- _class: pin-3 -->
<div class="tdiv">
> 四百年前,两位截然不同的科学家突破了当时已知世界的边界。1609 年在威尼斯,伽利略・伽利雷透过望远镜观察星辰,并制作仪器和进行实验。在布拉格,科班出身的神学家约翰内斯・开普勒发现了行星运动定律,奠定了近代天体物理学的基础,并思考着宇宙的宏伟构造。托马斯・德・帕多瓦以至今较少受到关注却扣人心弦的通信往来为基础,讲述了这两位类型如此迥异的学者之间不对等的关系,以及他们如何在同样的时刻却以各自的方式探索星辰的奥秘。在彼此的鉴照下,他们的远见与固执、睿智与无知得以呈现。这是一部介绍新科学的崛起以及近代来临之际的巨大变革的作品。 ——《宇宙的奥妙》
</div>
<div class="limg">
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131712626.png)
</div>
<div class="rimg">
![#c h:260](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131713779.png)
</div>
## 4.2 页面分栏与列表分列:列表分列
Awesome Marp v1.3 提供了 6 种列表分列的方式,分别为:
- `cols2_ol_sq`:呈现效果为[有序列表 + 方形序号](#32)
- `cols2_ol_ci`:呈现效果为[有序列表 + 圆形序号](#33)
- `cols2_ul_sq`:呈现效果为[无序列表 + 方形序号](#34)
- `cols2_ul_ci`:呈现效果为[无序列表 + 圆形序号](#35)
- `col1_ul_sq`:呈现效果为[有序列表 + 方形序号](#36)
- `col1_ul_ci`:呈现效应为[有序列表 + 圆形序号](#37)
## 《微观经济学:现代观点》
<!-- _class: cols2_ol_sq fglass -->
渲染效果为**有序列表+方形序号**
自定义样式为:`<!-- _class: cols2_ol_sq fglass -->`
- 偏好和效用
- 预算约束和消费者的最优选择
- 需求函数
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 博弈论
- 交换经济与生产经济
- 外部性与公共品
- 不确定性、期望效用和不对称信息
[返回](#28)
## 《微观经济学:现代观点》
<!-- _class: cols2_ol_ci fglass -->
渲染效果为**有序列表+圆形序号**
自定义样式为:`<!-- _class: cols2_ol_ci fglass -->`
- 偏好和效用
- 预算约束和消费者的最优选择
- 需求函数
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 博弈论
- 交换经济与生产经济
- 外部性与公共品
- 不确定性、期望效用和不对称信息
[返回](#28)
## 《置身事内》
<!-- _class: cols2_ul_sq fglass -->
渲染效果为**无序列表+方形序号**
自定义样式为:`<!-- _class: cols2_ul_sq fglass -->`
- 第一章:地方政府的权力与事务
- 第二章:财税与政府行为
- 第三章:政府投融资与债务
- 第四章:工业化中的政府角色
- 第五章:城市化与不平衡
- 第六章:债务与风险
- 第七章:国内国际失衡
- 第八章:政府与经济发展
[返回](#28)
## 《置身事内》
<!-- _class: cols2_ul_ci fglass -->
渲染效果为**无序列表+圆形序号**
自定义样式为:`<!-- _class: cols2_ul_ci fglass -->`
- 第一章:地方政府的权力与事务
- 第二章:财税与政府行为
- 第三章:政府投融资与债务
- 第四章:工业化中的政府角色
- 第五章:城市化与不平衡
- 第六章:债务与风险
- 第七章:国内国际失衡
- 第八章:政府与经济发展
[返回](#28)
## 《微观经济学:现代观点》
<!-- _class: col1_ol_sq fglass -->
渲染效果为**单列+有序列表+方形序号**
自定义样式为:`<!-- _class: col1_ul_sq fglass -->`
- 预算约束和消费者的最优选择
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 交换经济与生产经济
- 不确定性、期望效用和不对称信息
## 《微观经济学:现代观点》
<!-- _class: col1_ol_ci fglass -->
渲染效果为**单列+有序列表+圆形序号**
自定义样式为:`<!-- _class: col1_ul_ci fglass -->`
- 预算约束和消费者的最优选择
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 交换经济与生产经济
- 不确定性、期望效用和不对称信息
## 5. 引用、链接和 Callouts
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 5. 引用、链接和 Callouts
- 引用的呈现效果为:
> 合成控制法 (Synthetic Control Method) 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。
- 链接的呈现效果:
- [经管数据清洗与 Stata 实战:三大地级市数据库和 CSMAR 上市公司数据](https://mp.weixin.qq.com/s/D0cYVPJJsNiu61GcYwV6cg)
- [Stata 基础:从论文文件夹体系的建立说起](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486489&idx=1&sn=2eb51e85a01541c7a552a9434e087512&scene=21#wechat_redirect)
- Callouts 是 Awesome Marp 提供的自定义的样式,有 5 种颜色可选:
- [紫色](#40):`bq-purple`
- [蓝色](#41):`bq-blue`
- [绿色](#42):`bq-green`
- [红色](#43):`bq-red`
- [黑色](#44):`bq-black`
## 5. 引用、链接和引用盒子
<!-- _class: bq-purple -->
- 自定义样式为:`<!-- _class: bq-purple -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-blue -->
- 自定义样式为:`<!-- _class: bq-blue -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-green -->
- 自定义样式为:`<!-- _class: bq-green -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-red -->
- 自定义样式为:`<!-- _class: bq-red -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-black -->
- 自定义样式为:`<!-- _class: bq-black -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 6. 导航栏
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 6. 导航栏
<!-- _class: navbar -->
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* **导航栏** *基础知识*-->
- 一句题外话:打造 Awesome Marp 模板的最早初衷就是来自几位公众号粉丝朋友的询问,「Marp 是否也能实现想 Beamer 那样的顶部导航栏?」为了实现导航栏的效果,我又多学了一些 CSS 的知识,这套模板才得以成型
- 自定义样式为 `navbar`:`<!-- _class: navbar -->`
- 导航栏修改自 header,最前面必须加入 `\ `
- 当前活动标题,使用粗体 `**粗体**`
- 其余非活动标题,使用斜体 `*斜体*`
- 如果左侧有文字,需要使用斜粗体 `***粗斜体***`
- 默认根据内容自动分配间距,如果希望右对齐,可以手动增加空格的方式来推动右对齐
## 6. 导航栏
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* **导航栏** *基础知识*-->
<!-- _class: navbar -->
这张页面的部分 Markdown 源码:
```markdown
<!-- _class: navbar -->
<!-- _header: \ ***虹鹄山庄***
- 自定义样式为 `navbar`:`<!-- _class: navbar -->`
- 导航栏修改自 header,最前面必须加入 `\ `
- 当前活动标题:使用粗体 `**粗体**`
- 其余非活动标题:使用斜体 `*斜体*`
- 如果左侧有文字:使用斜粗体 `***粗斜体***`
- 默认根据内容自动分配间距,如果希望右对齐,可以手动增加空格的方式来推动右对齐
```
## 7. 其他自定义样式
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 7.1 固定标题行:更像 Beamer 了(`fixedtitleA`)
<!-- _class: fixedtitleA -->
- 自定义样式:`<!-- _class: fixedtitleA -->`
- 使当前页面的标题栏固定在顶部,而非随着内容的多少浮动
- 同时,页面内容也会从顶部起笔,而非垂直方向上居中显示
## 7.1 固定标题行:更像 Beamer 了(`fixedtitleB`)
<!-- _class: fixedtitleB -->
<div class="div">
- 自定义样式:`<!-- _class: fixedtitleB -->`
- `fixedtitleB` 相比于 `fixedtitleA`,标题增加了底色色块,同时缩小了标题大小
- 其余效果与 `fixedtitleA` 相同
- 但是页面正文内容需要包裹在 `<div class="div'></div>` 标签中
</div>
---
<!-- _class: footnote -->
<div class="tdiv">
#### 7.2 脚注的自定义样式:`footnote`
使用方法:
- 自定义样式:`<!-- _class: footnote -->`
- 页面除脚注外的其他内容,写在 `<div class = "tdiv"></div>`
- 页面的脚注内容,写在 `<div class = "bdiv"></div>`
举个例子,展示一下显示效果:
- 一方面,经济金融化程度的加深,使得金融部门能够凭借资本跨期配置提前抽取其他部门的未来价值,从而扩大金融和非金融部门之间的外部收入差距$^1$。另一方面,经济金融化不断增加企业股东权力,促使企业更加追求股东价值最大化,这一导向将弱化普通劳动者阶层的议价能力,食利者阶层的财产性收入增加必然会挤压劳动收入份额,从而扩大了内部收入差距$^2$。
</div>
<div class="bdiv">
1 张甜迪. 金融化对中国金融、非金融行业收入差距的影响[J]. 经济问题, 2015(11): 40-46.
2 Hein E. Finance-dominated capitalism and re-distribution of income: a Kaleckian perspective[J]. Cambridge Journal of Economics, 2015, 39(3): 907-934.
</div>
## 7.3 调节文字大小的自定义样式
<!-- _class: largetext -->
对于字体大小的调节,直接修改 CSS 文件应该很方便的。但有小伙伴提出,“希望可以增加字体调节的自定义样式”,于是目前提供了四种微调样式:
- 自定义样式 1:`<!-- _class: tinytext -->` (是默认字体大小的 0.8 倍)
- 自定义样式 2:`<!-- _class: smalltext -->` (是默认字体大小的 0.9 倍)
- 自定义样式 3:`<!-- _class: largetext -->` (是默认字体大小的 1.15 倍)
- 自定义样式 4:`<!-- _class: hugetext -->` (是默认字体大小的 1.3 倍)
比如,本页面采用的自定义样式为 `largetext`
## 7.4 图表标题的自定义样式:`caption`
<!-- _class: caption -->
- 通过 `<div class="caption">宇宙的奥妙</div>` 来定义图表的标题
![#c h:380](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131712626.png)
<div class="caption">
宇宙的奥妙
</div>
## 需要知道的基础知识……
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## Markdown 概览
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar -->
- Markdown 是一种**极轻量**的文本标记语言,允许人们使用**易读易写**的纯文本格式编写文档,而且对于表格、代码、图片、公式等支持良好
- 应用广泛:网站、课程笔记/讲义、演示文稿、撰写学术论文等
- Markdown 基础语法:
- 参阅:[Markdown 中文文档](https://markdown-zh.readthedocs.io/en/latest/)、[Markdown 指南](https://www.markdown.xyz/)、[Markdown 菜鸟教程](https://www.runoob.com/markdown/md-tutorial.html)
- 标题 `#`、粗体 `** **`、斜体 `* *`、删除线 `~~ ~~`、分割线 `---`、超链接 `[]()`
- 引用 `>`、列表 `-` / `1. `、代码块
- 脚注 `[^1]` / `[^1]:`、待办事项 `[ ]` / `[x]`
- Markdown 进阶语法:
- 图片 `![]()`:本地路径、网络路径(参阅:[图床与 PicGo——让你爱上记录与分享](https://sspai.com/post/65716))
- 数学公式:行内公式 `$...$`、行间公式 `$$...$$`
- 支持 HTML 元素:`<br>`/`<hr>`/`<b></b>`/`<i></i>`/`<kbd></kbd>` 等
## 推荐的 Markdown 编辑器
<!-- _class: cols-2-64 navbar -->
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<div class=ldiv>
**VS Code**
- Visual Studio Code[下载地址](https://code.visualstudio.com/Download)
- VS Code 插件:
- 配合 Markdown:[Markdown Preview Enhanced](https://marketplace.visualstudio.com/items?itemName=shd101wyy.markdown-preview-enhanced)、[Markdown All in One](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one)
- 图床:[PicGo](https://marketplace.visualstudio.com/items?itemName=Spades.vs-picgo)
- 格式化文档:[Pangu-Markdown](https://marketplace.visualstudio.com/items?itemName=xlthu.Pangu-Markdown)
- Markdown 转 PPT:[Marp for VScode](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode)
- Markdown 转思维导图:[Markmap for VScode](https://marketplace.visualstudio.com/items?itemName=gera2ld.markmap-vscode)
- 配合 Zotero:[Citation Picker for Zotero](https://marketplace.visualstudio.com/items?itemName=mblode.zotero)、[Pandoc Citer](https://marketplace.visualstudio.com/items?itemName=notZaki.pandocciter)
</div>
<div class=rdiv>
**Obsidian**
- [Obsidian 主页](https://obsidian.md/)
- 基于 Markdown 的本地知识管理软件
- 除官方同步和发布功能外,对个人使用者完全免费
- 功能丰富、插件众多、开发社区活跃
</div>
## Marp 基本用法
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar fixedtitleB -->
<div class="div">
- 几个字总结 [Marp](https://marp.app/):使用 Markdown 创作演示文稿
- 来自 Marp 官方网页的一段话:Marp (also known as the Markdown Presentation Ecosystem) provides an intuitive experience for creating beautiful slide decks. You only have to focus on writing your story in a Markdown document.
- 在 Markdown 文件的顶部 YAML 区域,通过 `marp: true` 启动 Marp,然后即可开启侧边预览,VS Code 界面左边是代码区域,右边为预览区域
- 内容遵循 Markdown 语法,但 Marp 增加了一些内置指令,而且指令分为全局指令和[局部指令](https://marpit.marp.app/directives?id=local-directives-1),全局指令建议放置于 YAML 区,局部指令位于当前页面,不同页面通过 `---` 切分
- 推荐阅读:Marpit [官方文档](https://marpit.marp.app)及[中译版](https://caizhiyuan.gitee.io/categories/skills/20200730-marp.html#%E5%8A%9F%E8%83%BD),五分钟学会 Marp[(上)](https://www.lianxh.cn/news/97fccdca2d7a5.html)、[(下)](https://www.lianxh.cn/news/521900220dd33.html)
</div>
## Marp 基本用法
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar -->
```yaml
---
marp: true # 开启 Marp
size: 16:9 # 设定页面比例,常见有 16:9 或 4:3,默认为16:9
theme: gaia # 切换主题,内置 3 种样式的主题,可以自定义主题
paginate: true # 开启页码
headingDivider: 2 # 通过二级标题切分页面,省去手动换页的麻烦
footer: 初虹 # 设置页脚区域的内容,如果设定页眉的内容,则为 header
---
```
- 如果想让页面同时被多个级别的标题切分,比如,以二级~四级标题分割页面,可以 `headingDivider: [2,3,4]`
- 想要使得多个自定义样式渲染同一个页面,可直接将不同自定义样式以空格连接,比如:`<!-- _class: cols-2-64 fglass -->`
---
<!-- _class: lastpage -->
<!-- _footer: "" -->
###### 欢迎交流 ~
<div class="icons">
- <i class="fa-solid fa-envelope"></i>
- 邮箱:ch2099058972@163.com
- <i class="fa-brands fa-weixin"></i>
- 微信:favourhong
- <i class="fa-solid fa-house"></i>
- 公众号:虹鹄山庄
<div>
## 创作不易,buy me a coffee 🤙~
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
<br>
![#c w:300](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309240907419.png)
Binary file not shown.
File diff suppressed because one or more lines are too long
+942
View File
@@ -0,0 +1,942 @@
---
marp: true
size: 16:9
theme: am_green
paginate: true
headingDivider:
- 2
- 3
footer: \ *初虹(虹鹄山庄)* *Awesome Marp:轻松取代 LaTeX Beamer!* *2024年1月13日(v1.3)*
created: 2025-09-09T18:22
updated: 2025-09-22T13:27
---
<!-- _class: cover_a
<!-- _header: "" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
# Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
## Awesome Marp 有什么?
<!-- _class: cols2_ol_ci fglass toc_a -->
<!-- _footer: "" -->
<!-- _header: "CONTENTS" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
## 1. 关于模板
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 1. 关于模板
- **开始之前:** 你需要知道这样几个工具,Markdown、Markdown 编辑器(VS Code 或 Obsidian)和 Marp。关于这三者是个啥,我不做详细地介绍,但在[第 55 页](#55)-[第 58 页](#58)会有一些凝练性的内容给你参考,同时我提供了不少的链接,也供你参阅。
- **为什么要开发 Awesome Marp?**
- Marp 原生仅提供 3 种主题(`default` / `gaia` / `uncover`),呈现效果一般。于是我根据自己的使用情况,边用边改造,陆续打磨了这样的一整套模板。
- **目前发布的 v1.3 有 38 个自定义样式、6 种颜色的主题**(后面有呈现效果)
- **Awesome Marp 的几个特色:**
- 支持分栏呈现、支持 Callouts(类似于 Beamer 中的定理框)、提供多种类型的封面页和目录页、可以实现导航进度栏、图片支持自定义居中/居左/居右对齐等
- 本着「开箱即用」的原则,我将本项目文件夹打包上传到了[GitHub](https://github.com/favourhong/Awesome-Marp) 和 [Gitee](https://gitee.com/favourhong/Awesome-Marp)
- 用到的工具:软件 [Visual Studio Code](https://code.visualstudio.com) 或 [Obsidian](https://obsidian.md/)、[Marp for VScode(插件)](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode)
## 1. 关于模板
- Awesome Marp 支持 38 个自定义样式,使用时需在页面指定(如 `<!-- _class: trans -->`):
| 封面页 | 目录页 | 列表 | 引用盒子 | 其他 1 | 其他 2 |
| --------- | ------- | ----------- | ----------- | ----------------------------- | --------------------------------------------------------------- |
| `cover_a` | `toc_a` | `cols-2` | `bq-black` | 过渡页面 `trans` | 图表等的标题 `caption` |
| `cover_b` | `toc_b` | `cols-2-64` | `bq-purple` | 最后一页 `lastpage` | 非嵌套无序列表的毛玻璃效果 `fglass` |
| `cover_c` | | `cols-2-73` | `bq-red` | 导航栏 `navbar` | 脚注:`footnote` |
| `cover_d` | | `cols-3` | `bq-blue` | 标题固定+无底色 `fixedtitleA` | 调节字体大小:`tinytext`/`smalltext`/<br>`largetext`/`hugetext` |
| `cover_e` | | `cols-2-46` | `bq-green` | 标题固定+有底色 `fixedtitleB` | |
| | | `cols-2-37` | | 两列有序列表 `cols2_ol_sq/ci` | |
| | | `rows-2` | | 两列无序列表 `cols_ul_sq/ci` | |
| | | `pin-3` | | 单列有序列表 `col1_ul_sq/ci` | |
## 1. 关于模板
- Awesome Marp 的主题色(6 种),可在 YAML 区切换 Theme,如 `theme: am_dark`:
| 深色 | 绿色 | 红色 | 蓝色 | 棕色 | 紫色
|---------|----------|--------|---------|----------|----|
| `am_dark` | `am_green` | `am_red` | `am_blue` | `am_brown` |`am_purple`|
## 1. 关于模板
- 如何使用:
- **搭配 VS Code**:直接使用 VS Code 打开 `Awesome-Marp` 文件夹
- 如果你想「拿来即用」,直接根据我分享的 Markdown 源码文件,对照修改就好了~
- 如果你对部分效果不满意、期望简单微调的话,目前在 `Awesome-Marp/themes` 下有 6 个 CSS 文件,这些 CSS 文件决定了 Markdown 源码的最终渲染效果,可以试着改一改~
- 如果你能够自行定制个性化 CSS 文件,渲染前,别忘在 `Awesome-Marp/.vscode/settings.json` 里加上你的 CSS 文件路径~
- **搭配 Obsidian**:安装 [Marp Slides 插件](https://github.com/samuele-cozzi/obsidian-marp-slides),并配置相应 CSS 路径
- 字体:因担心版权问题,需自行下载字体并安装,Awesome Marp 用到的字体有:
- 正文字体:`Latin Modern Math`、`方正宋刻本秀楷简体`,如果未安装,默认将使用 `Calibri` 和 `楷体`
- 标题字体:`Optima LT Medium`、`方正苏新诗柳楷简体`,如果未安装,默认将使用 `Arial` 和 `黑体`
- 脚注字体:`Charm` 和 `叶根友毛笔行书修正版`,如果未安装,默认将使用 `Calibri` 和 `楷体`
- 代码字体:`Fira Code` 和 `霞鹜文楷等宽`,如果未安装,默认将使用 `Consolas` 和 `华文中宋`
## 1. 关于模板:更新日志
- [Awesome Marp v1.0:我开发了一整套 Marp 主题,Markdown 转换的 PPT 也可以很好看!](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486787&idx=1&sn=2652ddae81f50240844cb652780912e1&chksm=c13ff94bf648705da1ba986b91265e3ff018acaffcfa60d7807a81be22176005e7a2b4483627&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.1:标题行不随正文浮动,这下更像 Beamer 了!](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486800&idx=1&sn=527348e242576079e4bd6cd1823c823a&chksm=c13ff958f648704e40a202db6ad5fa215ef4c189d66403e161d6ace9828406a8747ac755684f&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.2:增加脚注、调节字体大小等样式~](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486825&idx=1&sn=56d632ce164831438ec87c1b20ed4c4c&chksm=c13ff961f64870774f069ab816340783d8f54fd6b89363b8d9412c593efc640851ce9edd8833&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.3:几处小更新~](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486869&idx=1&sn=fcc377ff6a5930436e5078a09d53f0ab&chksm=c13ff99df648708b89bafba030b27909d0022279e26da723ca54a1666fe55f50a4230f050662&scene=178&cur_album_id=3132459596339757070#rd)
## 下面让我们看看效果吧 ~
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 2. 封面页
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 2. 封面页
- 大标题:采用一级标题 `# ` (如:`# Awesome Marp:自定义 Marp 主题`)
- 副标题:采用六级标题 `###### ` (如:`###### 打造简便又不失个性的演示文稿`)
- 本套模板提供 5 种封面页样式,使用时需要在页面中设定局部指令,如:`<!-- _class: cover_a -->`
- `cover_a`:[第 1 种](#1)
- `cover_b`:[第 2 种](#12)
- `cover_c`:预留 header 可设定学校 logo,footer 可设定校训 [第 3 种](#13)
- `cover_d`:只预留了 footer 设定校训 [第 4 种](#14)
- `cover_e`:预留 header 设定学校 logo,footer 设定学校 logo 和学校名称[第 5 种](#15)
- 如果已经设定了全局 footer、header 或页码,但又不期望在封面页中出现,可以 `<!-- _footer: "" -->` / `<!-- _header: "" -->` / `<!-- _paginate: "" -->` 分别将其局部隐藏起来
- 当标题文字超过页面宽度会溢出换行,这里可以使用 `<!-- fit -->` 根据页面宽度自动调整文字大小
---
<!-- _class: cover_b -->
<!-- _header: "" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
# Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_c -->
<!-- _paginate: "" -->
<!-- _footer: 厚德博学 经济匡时 -->
<!-- _header: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291116463.png) -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_d -->
<!-- _paginate: "" -->
<!-- _footer: "厚德博学 经济匡时" -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_e -->
<!-- _paginate: "" -->
<!-- _footer: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291116463.png) -->
<!-- _header: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291053273.png) -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
## 3. 目录页
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 3. 目录页
- Awesome Marp 提供了至少 2 种目录页样式,使用时同样需要设定局部样式
- `toc_a`:需要将 header 的内容设定为 `CONTENTS`,即 `<!-- _header: "CONTENTS" -->`
- `toc_b`:需要将 header 的内容设定为 `目录<br>CONTENTS<br>你的LOGO地址`,即 `<!-- _header: 目录<br>CONTENTS<br>![](./logo.png)-->`
- 提供的几种分栏列表样式,也可以作为目录页使用,如 `<!-- _class: cols2_ol_ci fglass -->`(效果见[这里](#32))
- 类似地,如果已经定义了全局 footer 或页码,可以使用 `<!-- _footer: "" -->` / `<!-- _paginate: "" -->` 分别将其局部隐藏起来
- 目录页样式:[第 1 种](#2)、[第 2 种](#18)和[第 3 种](#19)
---
<!-- _class: toc_a -->
<!-- _header: "CONTENTS" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
---
<!-- _header: 目录<br>CONTENTS<br>![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291053273.png)-->
<!-- _class: toc_b -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
## 4. 页面分栏与列表分列
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 4.1 页面分栏与列表分列:页面分栏
- Awesome Marp 提供了 8 种页面分栏方式,分别为:
- `cols-2`:[两列分栏,五五平分](#23)
- `cols-2-64`:[两列分栏,六四分](#24)
- `cols-2-73`:[两列分栏,七三分](#25)
- `cols-2-46`:[两列分栏,四六分](#26)
- `cols-2-37`:[两列分栏,三七分](#27)
- `cols-3`:[三列分栏,平分](#28)
- `rows-2`:[两行分栏](#29)
- `pin-3`:[品字型分栏](#30)
- 如果某一栏为图片,可以将 `class=ldiv` 换成 `class=limg`,这样能够实现图片的垂直居中对齐呢(`class=ldiv` 为居上对齐)
## 4.1 页面分栏与列表分列:页面分栏
- 以 `<!-- _class: cols-2 -->` 为例,Markdown 的源码为:
```markdown
<!-- _class: cols-2 -->
<div class=ldiv>
第一列(左侧栏)的内容在这里
内容可以是普通纯文本,可以是列表,也可以是引用块、链接、图片等
</div>
<div class=rdiv>
第二列(右侧栏)的内容在这里
</div>
```
- 如果是分三栏(`<!-- _class: cols-3 -->`),还需要再增加 `<div class="mdiv"></div>` 标签
## 《荷塘月色》(两栏五五分)
<!-- _class: cols-2 -->
<div class=ldiv>
曲曲折折的荷塘上面,弥望的是田田的叶子。叶子出水很高,像亭亭的舞女的裙。
层层的叶子中间,零星地点缀着些白花,有袅娜地开着的,有羞涩地打着朵儿的;正如一粒粒的明珠,又如碧天里的星星,又如刚出浴的美人。
微风过处,送来缕缕清香,仿佛远处高楼上渺茫的歌声似的。这时候叶子与花也有一丝的颤动,像闪电般,霎时传过荷塘的那边去了。
叶子本是肩并肩密密地挨着,这便宛然有了一道凝碧的波痕。叶子底下是脉脉的流水,遮住了,不能见一些颜色;而叶子却更见风致了。
—— 朱自清《荷塘月色》 [返回](#21)
</div>
<div class=rimg>
<!-- ![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221014499.png) -->
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221630151.png)
</div>
## 《春》(两栏六四分)
<!-- _class: cols-2-64 -->
<div class=limg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201217248.png)
</div>
<div class=rdiv>
盼望着,盼望着,东风来了,春天的脚步近了。
一切都像刚睡醒的样子,欣欣然张开了眼。山朗润起来了,水涨起来了,太阳的脸红起来了。
小草偷偷地从土里钻出来,嫩嫩的,绿绿的。园子里,田野里,瞧去,一大片一大片满是的。坐着,躺着,打两个滚,踢几脚球,赛几趟跑,捉几回迷藏。风轻悄悄的,草软绵绵的。
—— 朱自清《春》
[返回](#21)
</div>
## 经典散文诗篇(两栏七三分)
<!-- _class: cols-2-73 -->
<div class=limg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221010523.png)
</div>
<div class=rdiv>
经典的散文诗篇有:
- 朱自清:《荷塘月色》
- 林清玄:《月到天心》
- 郁达夫:《古都的秋》
- 张爱玲:《花落的声音》
- 余光中:《听听那冷雨》
- 张抗抗:《牡丹的拒绝》
- 丰子恺:《杨柳》
- 周作人:《乌篷船》
- 郑振铎:《石湖》
- 梁实秋:《雅舍》
[返回](#21)
</div>
## 《春》(两栏四六分)
<!-- _class: cols-2-46 -->
<div class=ldiv>
盼望着,盼望着,东风来了,春天的脚步近了。
一切都像刚睡醒的样子,欣欣然张开了眼。山朗润起来了,水涨起来了,太阳的脸红起来了。
小草偷偷地从土里钻出来,嫩嫩的,绿绿的。园子里,田野里,瞧去,一大片一大片满是的。坐着,躺着,打两个滚,踢几脚球,赛几趟跑,捉几回迷藏。风轻悄悄的,草软绵绵的。
—— 朱自清《春》
[返回](#21)
</div>
<div class=rimg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201217248.png)
</div>
## 经典散文诗篇(两栏三七分)
<!-- _class: cols-2-37 -->
<div class=ldiv>
经典的散文诗篇有:
- 朱自清:《荷塘月色》
- 林清玄:《月到天心》
- 郁达夫:《古都的秋》
- 张爱玲:《花落的声音》
- 余光中:《听听那冷雨》
- 张抗抗:《牡丹的拒绝》
- 丰子恺:《杨柳》
- 周作人:《乌篷船》
- 郑振铎:《石湖》
- 梁实秋:《雅舍》
[返回](#21)
</div>
<div class=rimg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221010523.png)
</div>
## 夏与秋(三栏三平分)
<!-- _class: cols-3 -->
<div class=ldiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201206630.png)
</div>
<div class=mdiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201151809.png)
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201158036.png)
</div>
<div class=rdiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201154535.png)
[返回](#21)
</div>
## 高山与沙漠(两行分栏)
<!-- _class: rows-2 -->
<div class="timg">
![#c h:250](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131736186.png)
</div>
<div class="bimg">
![#c h:260](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131737821.png)
</div>
## 《宇宙的奥秘》(品字型分栏)
<!-- _class: pin-3 -->
<div class="tdiv">
> 四百年前,两位截然不同的科学家突破了当时已知世界的边界。1609 年在威尼斯,伽利略・伽利雷透过望远镜观察星辰,并制作仪器和进行实验。在布拉格,科班出身的神学家约翰内斯・开普勒发现了行星运动定律,奠定了近代天体物理学的基础,并思考着宇宙的宏伟构造。托马斯・德・帕多瓦以至今较少受到关注却扣人心弦的通信往来为基础,讲述了这两位类型如此迥异的学者之间不对等的关系,以及他们如何在同样的时刻却以各自的方式探索星辰的奥秘。在彼此的鉴照下,他们的远见与固执、睿智与无知得以呈现。这是一部介绍新科学的崛起以及近代来临之际的巨大变革的作品。 ——《宇宙的奥妙》
</div>
<div class="limg">
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131712626.png)
</div>
<div class="rimg">
![#c h:260](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131713779.png)
</div>
## 4.2 页面分栏与列表分列:列表分列
Awesome Marp v1.3 提供了 6 种列表分列的方式,分别为:
- `cols2_ol_sq`:呈现效果为[有序列表 + 方形序号](#32)
- `cols2_ol_ci`:呈现效果为[有序列表 + 圆形序号](#33)
- `cols2_ul_sq`:呈现效果为[无序列表 + 方形序号](#34)
- `cols2_ul_ci`:呈现效果为[无序列表 + 圆形序号](#35)
- `col1_ul_sq`:呈现效果为[有序列表 + 方形序号](#36)
- `col1_ul_ci`:呈现效应为[有序列表 + 圆形序号](#37)
## 《微观经济学:现代观点》
<!-- _class: cols2_ol_sq fglass -->
渲染效果为**有序列表+方形序号**
自定义样式为:`<!-- _class: cols2_ol_sq fglass -->`
- 偏好和效用
- 预算约束和消费者的最优选择
- 需求函数
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 博弈论
- 交换经济与生产经济
- 外部性与公共品
- 不确定性、期望效用和不对称信息
[返回](#28)
## 《微观经济学:现代观点》
<!-- _class: cols2_ol_ci fglass -->
渲染效果为**有序列表+圆形序号**
自定义样式为:`<!-- _class: cols2_ol_ci fglass -->`
- 偏好和效用
- 预算约束和消费者的最优选择
- 需求函数
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 博弈论
- 交换经济与生产经济
- 外部性与公共品
- 不确定性、期望效用和不对称信息
[返回](#28)
## 《置身事内》
<!-- _class: cols2_ul_sq fglass -->
渲染效果为**无序列表+方形序号**
自定义样式为:`<!-- _class: cols2_ul_sq fglass -->`
- 第一章:地方政府的权力与事务
- 第二章:财税与政府行为
- 第三章:政府投融资与债务
- 第四章:工业化中的政府角色
- 第五章:城市化与不平衡
- 第六章:债务与风险
- 第七章:国内国际失衡
- 第八章:政府与经济发展
[返回](#28)
## 《置身事内》
<!-- _class: cols2_ul_ci fglass -->
渲染效果为**无序列表+圆形序号**
自定义样式为:`<!-- _class: cols2_ul_ci fglass -->`
- 第一章:地方政府的权力与事务
- 第二章:财税与政府行为
- 第三章:政府投融资与债务
- 第四章:工业化中的政府角色
- 第五章:城市化与不平衡
- 第六章:债务与风险
- 第七章:国内国际失衡
- 第八章:政府与经济发展
[返回](#28)
## 《微观经济学:现代观点》
<!-- _class: col1_ol_sq fglass -->
渲染效果为**单列+有序列表+方形序号**
自定义样式为:`<!-- _class: col1_ul_sq fglass -->`
- 预算约束和消费者的最优选择
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 交换经济与生产经济
- 不确定性、期望效用和不对称信息
## 《微观经济学:现代观点》
<!-- _class: col1_ol_ci fglass -->
渲染效果为**单列+有序列表+圆形序号**
自定义样式为:`<!-- _class: col1_ul_ci fglass -->`
- 预算约束和消费者的最优选择
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 交换经济与生产经济
- 不确定性、期望效用和不对称信息
## 5. 引用、链接和 Callouts
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 5. 引用、链接和 Callouts
- 引用的呈现效果为:
> 合成控制法 (Synthetic Control Method) 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。
- 链接的呈现效果:
- [经管数据清洗与 Stata 实战:三大地级市数据库和 CSMAR 上市公司数据](https://mp.weixin.qq.com/s/D0cYVPJJsNiu61GcYwV6cg)
- [Stata 基础:从论文文件夹体系的建立说起](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486489&idx=1&sn=2eb51e85a01541c7a552a9434e087512&scene=21#wechat_redirect)
- Callouts 是 Awesome Marp 提供的自定义的样式,有 5 种颜色可选:
- [紫色](#40):`bq-purple`
- [蓝色](#41):`bq-blue`
- [绿色](#42):`bq-green`
- [红色](#43):`bq-red`
- [黑色](#44):`bq-black`
## 5. 引用、链接和引用盒子
<!-- _class: bq-purple -->
- 自定义样式为:`<!-- _class: bq-purple -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-blue -->
- 自定义样式为:`<!-- _class: bq-blue -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-green -->
- 自定义样式为:`<!-- _class: bq-green -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-red -->
- 自定义样式为:`<!-- _class: bq-red -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-black -->
- 自定义样式为:`<!-- _class: bq-black -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 6. 导航栏
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 6. 导航栏
<!-- _class: navbar -->
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* **导航栏** *基础知识*-->
- 一句题外话:打造 Awesome Marp 模板的最早初衷就是来自几位公众号粉丝朋友的询问,「Marp 是否也能实现想 Beamer 那样的顶部导航栏?」为了实现导航栏的效果,我又多学了一些 CSS 的知识,这套模板才得以成型
- 自定义样式为 `navbar`:`<!-- _class: navbar -->`
- 导航栏修改自 header,最前面必须加入 `\ `
- 当前活动标题,使用粗体 `**粗体**`
- 其余非活动标题,使用斜体 `*斜体*`
- 如果左侧有文字,需要使用斜粗体 `***粗斜体***`
- 默认根据内容自动分配间距,如果希望右对齐,可以手动增加空格的方式来推动右对齐
## 6. 导航栏
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* **导航栏** *基础知识*-->
<!-- _class: navbar -->
这张页面的部分 Markdown 源码:
```markdown
<!-- _class: navbar -->
<!-- _header: \ ***虹鹄山庄***
- 自定义样式为 `navbar`:`<!-- _class: navbar -->`
- 导航栏修改自 header,最前面必须加入 `\ `
- 当前活动标题:使用粗体 `**粗体**`
- 其余非活动标题:使用斜体 `*斜体*`
- 如果左侧有文字:使用斜粗体 `***粗斜体***`
- 默认根据内容自动分配间距,如果希望右对齐,可以手动增加空格的方式来推动右对齐
```
## 7. 其他自定义样式
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 7.1 固定标题行:更像 Beamer 了(`fixedtitleA`)
<!-- _class: fixedtitleA -->
- 自定义样式:`<!-- _class: fixedtitleA -->`
- 使当前页面的标题栏固定在顶部,而非随着内容的多少浮动
- 同时,页面内容也会从顶部起笔,而非垂直方向上居中显示
## 7.1 固定标题行:更像 Beamer 了(`fixedtitleB`)
<!-- _class: fixedtitleB -->
<div class="div">
- 自定义样式:`<!-- _class: fixedtitleB -->`
- `fixedtitleB` 相比于 `fixedtitleA`,标题增加了底色色块,同时缩小了标题大小
- 其余效果与 `fixedtitleA` 相同
- 但是页面正文内容需要包裹在 `<div class="div'></div>` 标签中
</div>
---
<!-- _class: footnote -->
<div class="tdiv">
#### 7.2 脚注的自定义样式:`footnote`
使用方法:
- 自定义样式:`<!-- _class: footnote -->`
- 页面除脚注外的其他内容,写在 `<div class = "tdiv"></div>`
- 页面的脚注内容,写在 `<div class = "bdiv"></div>`
举个例子,展示一下显示效果:
- 一方面,经济金融化程度的加深,使得金融部门能够凭借资本跨期配置提前抽取其他部门的未来价值,从而扩大金融和非金融部门之间的外部收入差距$^1$。另一方面,经济金融化不断增加企业股东权力,促使企业更加追求股东价值最大化,这一导向将弱化普通劳动者阶层的议价能力,食利者阶层的财产性收入增加必然会挤压劳动收入份额,从而扩大了内部收入差距$^2$。
</div>
<div class="bdiv">
1 张甜迪. 金融化对中国金融、非金融行业收入差距的影响[J]. 经济问题, 2015(11): 40-46.
2 Hein E. Finance-dominated capitalism and re-distribution of income: a Kaleckian perspective[J]. Cambridge Journal of Economics, 2015, 39(3): 907-934.
</div>
## 7.3 调节文字大小的自定义样式
<!-- _class: largetext -->
对于字体大小的调节,直接修改 CSS 文件应该很方便的。但有小伙伴提出,“希望可以增加字体调节的自定义样式”,于是目前提供了四种微调样式:
- 自定义样式 1:`<!-- _class: tinytext -->` (是默认字体大小的 0.8 倍)
- 自定义样式 2:`<!-- _class: smalltext -->` (是默认字体大小的 0.9 倍)
- 自定义样式 3:`<!-- _class: largetext -->` (是默认字体大小的 1.15 倍)
- 自定义样式 4:`<!-- _class: hugetext -->` (是默认字体大小的 1.3 倍)
比如,本页面采用的自定义样式为 `largetext`
## 7.4 图表标题的自定义样式:`caption`
<!-- _class: caption -->
- 通过 `<div class="caption">宇宙的奥妙</div>` 来定义图表的标题
![#c h:380](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131712626.png)
<div class="caption">
宇宙的奥妙
</div>
## 需要知道的基础知识……
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## Markdown 概览
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar -->
- Markdown 是一种**极轻量**的文本标记语言,允许人们使用**易读易写**的纯文本格式编写文档,而且对于表格、代码、图片、公式等支持良好
- 应用广泛:网站、课程笔记/讲义、演示文稿、撰写学术论文等
- Markdown 基础语法:
- 参阅:[Markdown 中文文档](https://markdown-zh.readthedocs.io/en/latest/)、[Markdown 指南](https://www.markdown.xyz/)、[Markdown 菜鸟教程](https://www.runoob.com/markdown/md-tutorial.html)
- 标题 `#`、粗体 `** **`、斜体 `* *`、删除线 `~~ ~~`、分割线 `---`、超链接 `[]()`
- 引用 `>`、列表 `-` / `1. `、代码块
- 脚注 `[^1]` / `[^1]:`、待办事项 `[ ]` / `[x]`
- Markdown 进阶语法:
- 图片 `![]()`:本地路径、网络路径(参阅:[图床与 PicGo——让你爱上记录与分享](https://sspai.com/post/65716))
- 数学公式:行内公式 `$...$`、行间公式 `$$...$$`
- 支持 HTML 元素:`<br>`/`<hr>`/`<b></b>`/`<i></i>`/`<kbd></kbd>` 等
## 推荐的 Markdown 编辑器
<!-- _class: cols-2-64 navbar -->
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<div class=ldiv>
**VS Code**
- Visual Studio Code[下载地址](https://code.visualstudio.com/Download)
- VS Code 插件:
- 配合 Markdown:[Markdown Preview Enhanced](https://marketplace.visualstudio.com/items?itemName=shd101wyy.markdown-preview-enhanced)、[Markdown All in One](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one)
- 图床:[PicGo](https://marketplace.visualstudio.com/items?itemName=Spades.vs-picgo)
- 格式化文档:[Pangu-Markdown](https://marketplace.visualstudio.com/items?itemName=xlthu.Pangu-Markdown)
- Markdown 转 PPT:[Marp for VScode](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode)
- Markdown 转思维导图:[Markmap for VScode](https://marketplace.visualstudio.com/items?itemName=gera2ld.markmap-vscode)
- 配合 Zotero:[Citation Picker for Zotero](https://marketplace.visualstudio.com/items?itemName=mblode.zotero)、[Pandoc Citer](https://marketplace.visualstudio.com/items?itemName=notZaki.pandocciter)
</div>
<div class=rdiv>
**Obsidian**
- [Obsidian 主页](https://obsidian.md/)
- 基于 Markdown 的本地知识管理软件
- 除官方同步和发布功能外,对个人使用者完全免费
- 功能丰富、插件众多、开发社区活跃
</div>
## Marp 基本用法
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar fixedtitleB -->
<div class="div">
- 几个字总结 [Marp](https://marp.app/):使用 Markdown 创作演示文稿
- 来自 Marp 官方网页的一段话:Marp (also known as the Markdown Presentation Ecosystem) provides an intuitive experience for creating beautiful slide decks. You only have to focus on writing your story in a Markdown document.
- 在 Markdown 文件的顶部 YAML 区域,通过 `marp: true` 启动 Marp,然后即可开启侧边预览,VS Code 界面左边是代码区域,右边为预览区域
- 内容遵循 Markdown 语法,但 Marp 增加了一些内置指令,而且指令分为全局指令和[局部指令](https://marpit.marp.app/directives?id=local-directives-1),全局指令建议放置于 YAML 区,局部指令位于当前页面,不同页面通过 `---` 切分
- 推荐阅读:Marpit [官方文档](https://marpit.marp.app)及[中译版](https://caizhiyuan.gitee.io/categories/skills/20200730-marp.html#%E5%8A%9F%E8%83%BD),五分钟学会 Marp[(上)](https://www.lianxh.cn/news/97fccdca2d7a5.html)、[(下)](https://www.lianxh.cn/news/521900220dd33.html)
</div>
## Marp 基本用法
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar -->
```yaml
---
marp: true # 开启 Marp
size: 16:9 # 设定页面比例,常见有 16:9 或 4:3,默认为16:9
theme: gaia # 切换主题,内置 3 种样式的主题,可以自定义主题
paginate: true # 开启页码
headingDivider: 2 # 通过二级标题切分页面,省去手动换页的麻烦
footer: 初虹 # 设置页脚区域的内容,如果设定页眉的内容,则为 header
---
```
- 如果想让页面同时被多个级别的标题切分,比如,以二级~四级标题分割页面,可以 `headingDivider: [2,3,4]`
- 想要使得多个自定义样式渲染同一个页面,可直接将不同自定义样式以空格连接,比如:`<!-- _class: cols-2-64 fglass -->`
---
<!-- _class: lastpage -->
<!-- _footer: "" -->
###### 欢迎交流 ~
<div class="icons">
- <i class="fa-solid fa-envelope"></i>
- 邮箱:ch2099058972@163.com
- <i class="fa-brands fa-weixin"></i>
- 微信:favourhong
- <i class="fa-solid fa-house"></i>
- 公众号:虹鹄山庄
<div>
## 创作不易,buy me a coffee 🤙~
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
<br>
![#c w:300](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309240907419.png)
Binary file not shown.
File diff suppressed because one or more lines are too long
+942
View File
@@ -0,0 +1,942 @@
---
marp: true
size: 16:9
theme: am_purple
paginate: true
headingDivider:
- 2
- 3
footer: \ *初虹(虹鹄山庄)* *Awesome Marp:轻松取代 LaTeX Beamer!* *2024年1月13日(v1.3)*
created: 2025-09-09T18:22
updated: 2025-09-22T13:27
---
<!-- _class: cover_a
<!-- _header: "" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
# Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
## Awesome Marp 有什么?
<!-- _class: cols2_ol_ci fglass toc_a -->
<!-- _footer: "" -->
<!-- _header: "CONTENTS" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
## 1. 关于模板
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 1. 关于模板
- **开始之前:** 你需要知道这样几个工具,Markdown、Markdown 编辑器(VS Code 或 Obsidian)和 Marp。关于这三者是个啥,我不做详细地介绍,但在[第 55 页](#55)-[第 58 页](#58)会有一些凝练性的内容给你参考,同时我提供了不少的链接,也供你参阅。
- **为什么要开发 Awesome Marp?**
- Marp 原生仅提供 3 种主题(`default` / `gaia` / `uncover`),呈现效果一般。于是我根据自己的使用情况,边用边改造,陆续打磨了这样的一整套模板。
- **目前发布的 v1.3 有 38 个自定义样式、6 种颜色的主题**(后面有呈现效果)
- **Awesome Marp 的几个特色:**
- 支持分栏呈现、支持 Callouts(类似于 Beamer 中的定理框)、提供多种类型的封面页和目录页、可以实现导航进度栏、图片支持自定义居中/居左/居右对齐等
- 本着「开箱即用」的原则,我将本项目文件夹打包上传到了[GitHub](https://github.com/favourhong/Awesome-Marp) 和 [Gitee](https://gitee.com/favourhong/Awesome-Marp)
- 用到的工具:软件 [Visual Studio Code](https://code.visualstudio.com) 或 [Obsidian](https://obsidian.md/)、[Marp for VScode(插件)](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode)
## 1. 关于模板
- Awesome Marp 支持 38 个自定义样式,使用时需在页面指定(如 `<!-- _class: trans -->`):
| 封面页 | 目录页 | 列表 | 引用盒子 | 其他 1 | 其他 2 |
| --------- | ------- | ----------- | ----------- | ----------------------------- | --------------------------------------------------------------- |
| `cover_a` | `toc_a` | `cols-2` | `bq-black` | 过渡页面 `trans` | 图表等的标题 `caption` |
| `cover_b` | `toc_b` | `cols-2-64` | `bq-purple` | 最后一页 `lastpage` | 非嵌套无序列表的毛玻璃效果 `fglass` |
| `cover_c` | | `cols-2-73` | `bq-red` | 导航栏 `navbar` | 脚注:`footnote` |
| `cover_d` | | `cols-3` | `bq-blue` | 标题固定+无底色 `fixedtitleA` | 调节字体大小:`tinytext`/`smalltext`/<br>`largetext`/`hugetext` |
| `cover_e` | | `cols-2-46` | `bq-green` | 标题固定+有底色 `fixedtitleB` | |
| | | `cols-2-37` | | 两列有序列表 `cols2_ol_sq/ci` | |
| | | `rows-2` | | 两列无序列表 `cols_ul_sq/ci` | |
| | | `pin-3` | | 单列有序列表 `col1_ul_sq/ci` | |
## 1. 关于模板
- Awesome Marp 的主题色(6 种),可在 YAML 区切换 Theme,如 `theme: am_dark`:
| 深色 | 绿色 | 红色 | 蓝色 | 棕色 | 紫色
|---------|----------|--------|---------|----------|----|
| `am_dark` | `am_green` | `am_red` | `am_blue` | `am_brown` |`am_purple`|
## 1. 关于模板
- 如何使用:
- **搭配 VS Code**:直接使用 VS Code 打开 `Awesome-Marp` 文件夹
- 如果你想「拿来即用」,直接根据我分享的 Markdown 源码文件,对照修改就好了~
- 如果你对部分效果不满意、期望简单微调的话,目前在 `Awesome-Marp/themes` 下有 6 个 CSS 文件,这些 CSS 文件决定了 Markdown 源码的最终渲染效果,可以试着改一改~
- 如果你能够自行定制个性化 CSS 文件,渲染前,别忘在 `Awesome-Marp/.vscode/settings.json` 里加上你的 CSS 文件路径~
- **搭配 Obsidian**:安装 [Marp Slides 插件](https://github.com/samuele-cozzi/obsidian-marp-slides),并配置相应 CSS 路径
- 字体:因担心版权问题,需自行下载字体并安装,Awesome Marp 用到的字体有:
- 正文字体:`Latin Modern Math`、`方正宋刻本秀楷简体`,如果未安装,默认将使用 `Calibri` 和 `楷体`
- 标题字体:`Optima LT Medium`、`方正苏新诗柳楷简体`,如果未安装,默认将使用 `Arial` 和 `黑体`
- 脚注字体:`Charm` 和 `叶根友毛笔行书修正版`,如果未安装,默认将使用 `Calibri` 和 `楷体`
- 代码字体:`Fira Code` 和 `霞鹜文楷等宽`,如果未安装,默认将使用 `Consolas` 和 `华文中宋`
## 1. 关于模板:更新日志
- [Awesome Marp v1.0:我开发了一整套 Marp 主题,Markdown 转换的 PPT 也可以很好看!](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486787&idx=1&sn=2652ddae81f50240844cb652780912e1&chksm=c13ff94bf648705da1ba986b91265e3ff018acaffcfa60d7807a81be22176005e7a2b4483627&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.1:标题行不随正文浮动,这下更像 Beamer 了!](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486800&idx=1&sn=527348e242576079e4bd6cd1823c823a&chksm=c13ff958f648704e40a202db6ad5fa215ef4c189d66403e161d6ace9828406a8747ac755684f&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.2:增加脚注、调节字体大小等样式~](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486825&idx=1&sn=56d632ce164831438ec87c1b20ed4c4c&chksm=c13ff961f64870774f069ab816340783d8f54fd6b89363b8d9412c593efc640851ce9edd8833&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.3:几处小更新~](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486869&idx=1&sn=fcc377ff6a5930436e5078a09d53f0ab&chksm=c13ff99df648708b89bafba030b27909d0022279e26da723ca54a1666fe55f50a4230f050662&scene=178&cur_album_id=3132459596339757070#rd)
## 下面让我们看看效果吧 ~
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 2. 封面页
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 2. 封面页
- 大标题:采用一级标题 `# ` (如:`# Awesome Marp:自定义 Marp 主题`)
- 副标题:采用六级标题 `###### ` (如:`###### 打造简便又不失个性的演示文稿`)
- 本套模板提供 5 种封面页样式,使用时需要在页面中设定局部指令,如:`<!-- _class: cover_a -->`
- `cover_a`:[第 1 种](#1)
- `cover_b`:[第 2 种](#12)
- `cover_c`:预留 header 可设定学校 logo,footer 可设定校训 [第 3 种](#13)
- `cover_d`:只预留了 footer 设定校训 [第 4 种](#14)
- `cover_e`:预留 header 设定学校 logo,footer 设定学校 logo 和学校名称[第 5 种](#15)
- 如果已经设定了全局 footer、header 或页码,但又不期望在封面页中出现,可以 `<!-- _footer: "" -->` / `<!-- _header: "" -->` / `<!-- _paginate: "" -->` 分别将其局部隐藏起来
- 当标题文字超过页面宽度会溢出换行,这里可以使用 `<!-- fit -->` 根据页面宽度自动调整文字大小
---
<!-- _class: cover_b -->
<!-- _header: "" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
# Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_c -->
<!-- _paginate: "" -->
<!-- _footer: 厚德博学 经济匡时 -->
<!-- _header: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291116463.png) -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_d -->
<!-- _paginate: "" -->
<!-- _footer: "厚德博学 经济匡时" -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_e -->
<!-- _paginate: "" -->
<!-- _footer: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291116463.png) -->
<!-- _header: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291053273.png) -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
## 3. 目录页
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 3. 目录页
- Awesome Marp 提供了至少 2 种目录页样式,使用时同样需要设定局部样式
- `toc_a`:需要将 header 的内容设定为 `CONTENTS`,即 `<!-- _header: "CONTENTS" -->`
- `toc_b`:需要将 header 的内容设定为 `目录<br>CONTENTS<br>你的LOGO地址`,即 `<!-- _header: 目录<br>CONTENTS<br>![](./logo.png)-->`
- 提供的几种分栏列表样式,也可以作为目录页使用,如 `<!-- _class: cols2_ol_ci fglass -->`(效果见[这里](#32))
- 类似地,如果已经定义了全局 footer 或页码,可以使用 `<!-- _footer: "" -->` / `<!-- _paginate: "" -->` 分别将其局部隐藏起来
- 目录页样式:[第 1 种](#2)、[第 2 种](#18)和[第 3 种](#19)
---
<!-- _class: toc_a -->
<!-- _header: "CONTENTS" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
---
<!-- _header: 目录<br>CONTENTS<br>![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291053273.png)-->
<!-- _class: toc_b -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
## 4. 页面分栏与列表分列
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 4.1 页面分栏与列表分列:页面分栏
- Awesome Marp 提供了 8 种页面分栏方式,分别为:
- `cols-2`:[两列分栏,五五平分](#23)
- `cols-2-64`:[两列分栏,六四分](#24)
- `cols-2-73`:[两列分栏,七三分](#25)
- `cols-2-46`:[两列分栏,四六分](#26)
- `cols-2-37`:[两列分栏,三七分](#27)
- `cols-3`:[三列分栏,平分](#28)
- `rows-2`:[两行分栏](#29)
- `pin-3`:[品字型分栏](#30)
- 如果某一栏为图片,可以将 `class=ldiv` 换成 `class=limg`,这样能够实现图片的垂直居中对齐呢(`class=ldiv` 为居上对齐)
## 4.1 页面分栏与列表分列:页面分栏
- 以 `<!-- _class: cols-2 -->` 为例,Markdown 的源码为:
```markdown
<!-- _class: cols-2 -->
<div class=ldiv>
第一列(左侧栏)的内容在这里
内容可以是普通纯文本,可以是列表,也可以是引用块、链接、图片等
</div>
<div class=rdiv>
第二列(右侧栏)的内容在这里
</div>
```
- 如果是分三栏(`<!-- _class: cols-3 -->`),还需要再增加 `<div class="mdiv"></div>` 标签
## 《荷塘月色》(两栏五五分)
<!-- _class: cols-2 -->
<div class=ldiv>
曲曲折折的荷塘上面,弥望的是田田的叶子。叶子出水很高,像亭亭的舞女的裙。
层层的叶子中间,零星地点缀着些白花,有袅娜地开着的,有羞涩地打着朵儿的;正如一粒粒的明珠,又如碧天里的星星,又如刚出浴的美人。
微风过处,送来缕缕清香,仿佛远处高楼上渺茫的歌声似的。这时候叶子与花也有一丝的颤动,像闪电般,霎时传过荷塘的那边去了。
叶子本是肩并肩密密地挨着,这便宛然有了一道凝碧的波痕。叶子底下是脉脉的流水,遮住了,不能见一些颜色;而叶子却更见风致了。
—— 朱自清《荷塘月色》 [返回](#21)
</div>
<div class=rimg>
<!-- ![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221014499.png) -->
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221630151.png)
</div>
## 《春》(两栏六四分)
<!-- _class: cols-2-64 -->
<div class=limg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201217248.png)
</div>
<div class=rdiv>
盼望着,盼望着,东风来了,春天的脚步近了。
一切都像刚睡醒的样子,欣欣然张开了眼。山朗润起来了,水涨起来了,太阳的脸红起来了。
小草偷偷地从土里钻出来,嫩嫩的,绿绿的。园子里,田野里,瞧去,一大片一大片满是的。坐着,躺着,打两个滚,踢几脚球,赛几趟跑,捉几回迷藏。风轻悄悄的,草软绵绵的。
—— 朱自清《春》
[返回](#21)
</div>
## 经典散文诗篇(两栏七三分)
<!-- _class: cols-2-73 -->
<div class=limg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221010523.png)
</div>
<div class=rdiv>
经典的散文诗篇有:
- 朱自清:《荷塘月色》
- 林清玄:《月到天心》
- 郁达夫:《古都的秋》
- 张爱玲:《花落的声音》
- 余光中:《听听那冷雨》
- 张抗抗:《牡丹的拒绝》
- 丰子恺:《杨柳》
- 周作人:《乌篷船》
- 郑振铎:《石湖》
- 梁实秋:《雅舍》
[返回](#21)
</div>
## 《春》(两栏四六分)
<!-- _class: cols-2-46 -->
<div class=ldiv>
盼望着,盼望着,东风来了,春天的脚步近了。
一切都像刚睡醒的样子,欣欣然张开了眼。山朗润起来了,水涨起来了,太阳的脸红起来了。
小草偷偷地从土里钻出来,嫩嫩的,绿绿的。园子里,田野里,瞧去,一大片一大片满是的。坐着,躺着,打两个滚,踢几脚球,赛几趟跑,捉几回迷藏。风轻悄悄的,草软绵绵的。
—— 朱自清《春》
[返回](#21)
</div>
<div class=rimg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201217248.png)
</div>
## 经典散文诗篇(两栏三七分)
<!-- _class: cols-2-37 -->
<div class=ldiv>
经典的散文诗篇有:
- 朱自清:《荷塘月色》
- 林清玄:《月到天心》
- 郁达夫:《古都的秋》
- 张爱玲:《花落的声音》
- 余光中:《听听那冷雨》
- 张抗抗:《牡丹的拒绝》
- 丰子恺:《杨柳》
- 周作人:《乌篷船》
- 郑振铎:《石湖》
- 梁实秋:《雅舍》
[返回](#21)
</div>
<div class=rimg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221010523.png)
</div>
## 夏与秋(三栏三平分)
<!-- _class: cols-3 -->
<div class=ldiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201206630.png)
</div>
<div class=mdiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201151809.png)
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201158036.png)
</div>
<div class=rdiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201154535.png)
[返回](#21)
</div>
## 高山与沙漠(两行分栏)
<!-- _class: rows-2 -->
<div class="timg">
![#c h:250](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131736186.png)
</div>
<div class="bimg">
![#c h:260](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131737821.png)
</div>
## 《宇宙的奥秘》(品字型分栏)
<!-- _class: pin-3 -->
<div class="tdiv">
> 四百年前,两位截然不同的科学家突破了当时已知世界的边界。1609 年在威尼斯,伽利略・伽利雷透过望远镜观察星辰,并制作仪器和进行实验。在布拉格,科班出身的神学家约翰内斯・开普勒发现了行星运动定律,奠定了近代天体物理学的基础,并思考着宇宙的宏伟构造。托马斯・德・帕多瓦以至今较少受到关注却扣人心弦的通信往来为基础,讲述了这两位类型如此迥异的学者之间不对等的关系,以及他们如何在同样的时刻却以各自的方式探索星辰的奥秘。在彼此的鉴照下,他们的远见与固执、睿智与无知得以呈现。这是一部介绍新科学的崛起以及近代来临之际的巨大变革的作品。 ——《宇宙的奥妙》
</div>
<div class="limg">
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131712626.png)
</div>
<div class="rimg">
![#c h:260](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131713779.png)
</div>
## 4.2 页面分栏与列表分列:列表分列
Awesome Marp v1.3 提供了 6 种列表分列的方式,分别为:
- `cols2_ol_sq`:呈现效果为[有序列表 + 方形序号](#32)
- `cols2_ol_ci`:呈现效果为[有序列表 + 圆形序号](#33)
- `cols2_ul_sq`:呈现效果为[无序列表 + 方形序号](#34)
- `cols2_ul_ci`:呈现效果为[无序列表 + 圆形序号](#35)
- `col1_ul_sq`:呈现效果为[有序列表 + 方形序号](#36)
- `col1_ul_ci`:呈现效应为[有序列表 + 圆形序号](#37)
## 《微观经济学:现代观点》
<!-- _class: cols2_ol_sq fglass -->
渲染效果为**有序列表+方形序号**
自定义样式为:`<!-- _class: cols2_ol_sq fglass -->`
- 偏好和效用
- 预算约束和消费者的最优选择
- 需求函数
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 博弈论
- 交换经济与生产经济
- 外部性与公共品
- 不确定性、期望效用和不对称信息
[返回](#28)
## 《微观经济学:现代观点》
<!-- _class: cols2_ol_ci fglass -->
渲染效果为**有序列表+圆形序号**
自定义样式为:`<!-- _class: cols2_ol_ci fglass -->`
- 偏好和效用
- 预算约束和消费者的最优选择
- 需求函数
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 博弈论
- 交换经济与生产经济
- 外部性与公共品
- 不确定性、期望效用和不对称信息
[返回](#28)
## 《置身事内》
<!-- _class: cols2_ul_sq fglass -->
渲染效果为**无序列表+方形序号**
自定义样式为:`<!-- _class: cols2_ul_sq fglass -->`
- 第一章:地方政府的权力与事务
- 第二章:财税与政府行为
- 第三章:政府投融资与债务
- 第四章:工业化中的政府角色
- 第五章:城市化与不平衡
- 第六章:债务与风险
- 第七章:国内国际失衡
- 第八章:政府与经济发展
[返回](#28)
## 《置身事内》
<!-- _class: cols2_ul_ci fglass -->
渲染效果为**无序列表+圆形序号**
自定义样式为:`<!-- _class: cols2_ul_ci fglass -->`
- 第一章:地方政府的权力与事务
- 第二章:财税与政府行为
- 第三章:政府投融资与债务
- 第四章:工业化中的政府角色
- 第五章:城市化与不平衡
- 第六章:债务与风险
- 第七章:国内国际失衡
- 第八章:政府与经济发展
[返回](#28)
## 《微观经济学:现代观点》
<!-- _class: col1_ol_sq fglass -->
渲染效果为**单列+有序列表+方形序号**
自定义样式为:`<!-- _class: col1_ul_sq fglass -->`
- 预算约束和消费者的最优选择
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 交换经济与生产经济
- 不确定性、期望效用和不对称信息
## 《微观经济学:现代观点》
<!-- _class: col1_ol_ci fglass -->
渲染效果为**单列+有序列表+圆形序号**
自定义样式为:`<!-- _class: col1_ul_ci fglass -->`
- 预算约束和消费者的最优选择
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 交换经济与生产经济
- 不确定性、期望效用和不对称信息
## 5. 引用、链接和 Callouts
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 5. 引用、链接和 Callouts
- 引用的呈现效果为:
> 合成控制法 (Synthetic Control Method) 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。
- 链接的呈现效果:
- [经管数据清洗与 Stata 实战:三大地级市数据库和 CSMAR 上市公司数据](https://mp.weixin.qq.com/s/D0cYVPJJsNiu61GcYwV6cg)
- [Stata 基础:从论文文件夹体系的建立说起](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486489&idx=1&sn=2eb51e85a01541c7a552a9434e087512&scene=21#wechat_redirect)
- Callouts 是 Awesome Marp 提供的自定义的样式,有 5 种颜色可选:
- [紫色](#40):`bq-purple`
- [蓝色](#41):`bq-blue`
- [绿色](#42):`bq-green`
- [红色](#43):`bq-red`
- [黑色](#44):`bq-black`
## 5. 引用、链接和引用盒子
<!-- _class: bq-purple -->
- 自定义样式为:`<!-- _class: bq-purple -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-blue -->
- 自定义样式为:`<!-- _class: bq-blue -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-green -->
- 自定义样式为:`<!-- _class: bq-green -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-red -->
- 自定义样式为:`<!-- _class: bq-red -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-black -->
- 自定义样式为:`<!-- _class: bq-black -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 6. 导航栏
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 6. 导航栏
<!-- _class: navbar -->
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* **导航栏** *基础知识*-->
- 一句题外话:打造 Awesome Marp 模板的最早初衷就是来自几位公众号粉丝朋友的询问,「Marp 是否也能实现想 Beamer 那样的顶部导航栏?」为了实现导航栏的效果,我又多学了一些 CSS 的知识,这套模板才得以成型
- 自定义样式为 `navbar`:`<!-- _class: navbar -->`
- 导航栏修改自 header,最前面必须加入 `\ `
- 当前活动标题,使用粗体 `**粗体**`
- 其余非活动标题,使用斜体 `*斜体*`
- 如果左侧有文字,需要使用斜粗体 `***粗斜体***`
- 默认根据内容自动分配间距,如果希望右对齐,可以手动增加空格的方式来推动右对齐
## 6. 导航栏
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* **导航栏** *基础知识*-->
<!-- _class: navbar -->
这张页面的部分 Markdown 源码:
```markdown
<!-- _class: navbar -->
<!-- _header: \ ***虹鹄山庄***
- 自定义样式为 `navbar`:`<!-- _class: navbar -->`
- 导航栏修改自 header,最前面必须加入 `\ `
- 当前活动标题:使用粗体 `**粗体**`
- 其余非活动标题:使用斜体 `*斜体*`
- 如果左侧有文字:使用斜粗体 `***粗斜体***`
- 默认根据内容自动分配间距,如果希望右对齐,可以手动增加空格的方式来推动右对齐
```
## 7. 其他自定义样式
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 7.1 固定标题行:更像 Beamer 了(`fixedtitleA`)
<!-- _class: fixedtitleA -->
- 自定义样式:`<!-- _class: fixedtitleA -->`
- 使当前页面的标题栏固定在顶部,而非随着内容的多少浮动
- 同时,页面内容也会从顶部起笔,而非垂直方向上居中显示
## 7.1 固定标题行:更像 Beamer 了(`fixedtitleB`)
<!-- _class: fixedtitleB -->
<div class="div">
- 自定义样式:`<!-- _class: fixedtitleB -->`
- `fixedtitleB` 相比于 `fixedtitleA`,标题增加了底色色块,同时缩小了标题大小
- 其余效果与 `fixedtitleA` 相同
- 但是页面正文内容需要包裹在 `<div class="div'></div>` 标签中
</div>
---
<!-- _class: footnote -->
<div class="tdiv">
#### 7.2 脚注的自定义样式:`footnote`
使用方法:
- 自定义样式:`<!-- _class: footnote -->`
- 页面除脚注外的其他内容,写在 `<div class = "tdiv"></div>`
- 页面的脚注内容,写在 `<div class = "bdiv"></div>`
举个例子,展示一下显示效果:
- 一方面,经济金融化程度的加深,使得金融部门能够凭借资本跨期配置提前抽取其他部门的未来价值,从而扩大金融和非金融部门之间的外部收入差距$^1$。另一方面,经济金融化不断增加企业股东权力,促使企业更加追求股东价值最大化,这一导向将弱化普通劳动者阶层的议价能力,食利者阶层的财产性收入增加必然会挤压劳动收入份额,从而扩大了内部收入差距$^2$。
</div>
<div class="bdiv">
1 张甜迪. 金融化对中国金融、非金融行业收入差距的影响[J]. 经济问题, 2015(11): 40-46.
2 Hein E. Finance-dominated capitalism and re-distribution of income: a Kaleckian perspective[J]. Cambridge Journal of Economics, 2015, 39(3): 907-934.
</div>
## 7.3 调节文字大小的自定义样式
<!-- _class: largetext -->
对于字体大小的调节,直接修改 CSS 文件应该很方便的。但有小伙伴提出,“希望可以增加字体调节的自定义样式”,于是目前提供了四种微调样式:
- 自定义样式 1:`<!-- _class: tinytext -->` (是默认字体大小的 0.8 倍)
- 自定义样式 2:`<!-- _class: smalltext -->` (是默认字体大小的 0.9 倍)
- 自定义样式 3:`<!-- _class: largetext -->` (是默认字体大小的 1.15 倍)
- 自定义样式 4:`<!-- _class: hugetext -->` (是默认字体大小的 1.3 倍)
比如,本页面采用的自定义样式为 `largetext`
## 7.4 图表标题的自定义样式:`caption`
<!-- _class: caption -->
- 通过 `<div class="caption">宇宙的奥妙</div>` 来定义图表的标题
![#c h:380](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131712626.png)
<div class="caption">
宇宙的奥妙
</div>
## 需要知道的基础知识……
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## Markdown 概览
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar -->
- Markdown 是一种**极轻量**的文本标记语言,允许人们使用**易读易写**的纯文本格式编写文档,而且对于表格、代码、图片、公式等支持良好
- 应用广泛:网站、课程笔记/讲义、演示文稿、撰写学术论文等
- Markdown 基础语法:
- 参阅:[Markdown 中文文档](https://markdown-zh.readthedocs.io/en/latest/)、[Markdown 指南](https://www.markdown.xyz/)、[Markdown 菜鸟教程](https://www.runoob.com/markdown/md-tutorial.html)
- 标题 `#`、粗体 `** **`、斜体 `* *`、删除线 `~~ ~~`、分割线 `---`、超链接 `[]()`
- 引用 `>`、列表 `-` / `1. `、代码块
- 脚注 `[^1]` / `[^1]:`、待办事项 `[ ]` / `[x]`
- Markdown 进阶语法:
- 图片 `![]()`:本地路径、网络路径(参阅:[图床与 PicGo——让你爱上记录与分享](https://sspai.com/post/65716))
- 数学公式:行内公式 `$...$`、行间公式 `$$...$$`
- 支持 HTML 元素:`<br>`/`<hr>`/`<b></b>`/`<i></i>`/`<kbd></kbd>` 等
## 推荐的 Markdown 编辑器
<!-- _class: cols-2-64 navbar -->
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<div class=ldiv>
**VS Code**
- Visual Studio Code[下载地址](https://code.visualstudio.com/Download)
- VS Code 插件:
- 配合 Markdown:[Markdown Preview Enhanced](https://marketplace.visualstudio.com/items?itemName=shd101wyy.markdown-preview-enhanced)、[Markdown All in One](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one)
- 图床:[PicGo](https://marketplace.visualstudio.com/items?itemName=Spades.vs-picgo)
- 格式化文档:[Pangu-Markdown](https://marketplace.visualstudio.com/items?itemName=xlthu.Pangu-Markdown)
- Markdown 转 PPT:[Marp for VScode](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode)
- Markdown 转思维导图:[Markmap for VScode](https://marketplace.visualstudio.com/items?itemName=gera2ld.markmap-vscode)
- 配合 Zotero:[Citation Picker for Zotero](https://marketplace.visualstudio.com/items?itemName=mblode.zotero)、[Pandoc Citer](https://marketplace.visualstudio.com/items?itemName=notZaki.pandocciter)
</div>
<div class=rdiv>
**Obsidian**
- [Obsidian 主页](https://obsidian.md/)
- 基于 Markdown 的本地知识管理软件
- 除官方同步和发布功能外,对个人使用者完全免费
- 功能丰富、插件众多、开发社区活跃
</div>
## Marp 基本用法
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar fixedtitleB -->
<div class="div">
- 几个字总结 [Marp](https://marp.app/):使用 Markdown 创作演示文稿
- 来自 Marp 官方网页的一段话:Marp (also known as the Markdown Presentation Ecosystem) provides an intuitive experience for creating beautiful slide decks. You only have to focus on writing your story in a Markdown document.
- 在 Markdown 文件的顶部 YAML 区域,通过 `marp: true` 启动 Marp,然后即可开启侧边预览,VS Code 界面左边是代码区域,右边为预览区域
- 内容遵循 Markdown 语法,但 Marp 增加了一些内置指令,而且指令分为全局指令和[局部指令](https://marpit.marp.app/directives?id=local-directives-1),全局指令建议放置于 YAML 区,局部指令位于当前页面,不同页面通过 `---` 切分
- 推荐阅读:Marpit [官方文档](https://marpit.marp.app)及[中译版](https://caizhiyuan.gitee.io/categories/skills/20200730-marp.html#%E5%8A%9F%E8%83%BD),五分钟学会 Marp[(上)](https://www.lianxh.cn/news/97fccdca2d7a5.html)、[(下)](https://www.lianxh.cn/news/521900220dd33.html)
</div>
## Marp 基本用法
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar -->
```yaml
---
marp: true # 开启 Marp
size: 16:9 # 设定页面比例,常见有 16:9 或 4:3,默认为16:9
theme: gaia # 切换主题,内置 3 种样式的主题,可以自定义主题
paginate: true # 开启页码
headingDivider: 2 # 通过二级标题切分页面,省去手动换页的麻烦
footer: 初虹 # 设置页脚区域的内容,如果设定页眉的内容,则为 header
---
```
- 如果想让页面同时被多个级别的标题切分,比如,以二级~四级标题分割页面,可以 `headingDivider: [2,3,4]`
- 想要使得多个自定义样式渲染同一个页面,可直接将不同自定义样式以空格连接,比如:`<!-- _class: cols-2-64 fglass -->`
---
<!-- _class: lastpage -->
<!-- _footer: "" -->
###### 欢迎交流 ~
<div class="icons">
- <i class="fa-solid fa-envelope"></i>
- 邮箱:ch2099058972@163.com
- <i class="fa-brands fa-weixin"></i>
- 微信:favourhong
- <i class="fa-solid fa-house"></i>
- 公众号:虹鹄山庄
<div>
## 创作不易,buy me a coffee 🤙~
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
<br>
![#c w:300](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309240907419.png)
Binary file not shown.
File diff suppressed because one or more lines are too long
+942
View File
@@ -0,0 +1,942 @@
---
marp: true
size: 16:9
theme: am_red
paginate: true
headingDivider:
- 2
- 3
footer: \ *初虹(虹鹄山庄)* *Awesome Marp:轻松取代 LaTeX Beamer!* *2024年1月13日(v1.3)*
created: 2025-09-09T18:22
updated: 2025-09-22T13:27
---
<!-- _class: cover_a
<!-- _header: "" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
# Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
## Awesome Marp 有什么?
<!-- _class: cols2_ol_ci fglass toc_a -->
<!-- _footer: "" -->
<!-- _header: "CONTENTS" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
## 1. 关于模板
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 1. 关于模板
- **开始之前:** 你需要知道这样几个工具,Markdown、Markdown 编辑器(VS Code 或 Obsidian)和 Marp。关于这三者是个啥,我不做详细地介绍,但在[第 55 页](#55)-[第 58 页](#58)会有一些凝练性的内容给你参考,同时我提供了不少的链接,也供你参阅。
- **为什么要开发 Awesome Marp?**
- Marp 原生仅提供 3 种主题(`default` / `gaia` / `uncover`),呈现效果一般。于是我根据自己的使用情况,边用边改造,陆续打磨了这样的一整套模板。
- **目前发布的 v1.3 有 38 个自定义样式、6 种颜色的主题**(后面有呈现效果)
- **Awesome Marp 的几个特色:**
- 支持分栏呈现、支持 Callouts(类似于 Beamer 中的定理框)、提供多种类型的封面页和目录页、可以实现导航进度栏、图片支持自定义居中/居左/居右对齐等
- 本着「开箱即用」的原则,我将本项目文件夹打包上传到了[GitHub](https://github.com/favourhong/Awesome-Marp) 和 [Gitee](https://gitee.com/favourhong/Awesome-Marp)
- 用到的工具:软件 [Visual Studio Code](https://code.visualstudio.com) 或 [Obsidian](https://obsidian.md/)、[Marp for VScode(插件)](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode)
## 1. 关于模板
- Awesome Marp 支持 38 个自定义样式,使用时需在页面指定(如 `<!-- _class: trans -->`):
| 封面页 | 目录页 | 列表 | 引用盒子 | 其他 1 | 其他 2 |
| --------- | ------- | ----------- | ----------- | ----------------------------- | --------------------------------------------------------------- |
| `cover_a` | `toc_a` | `cols-2` | `bq-black` | 过渡页面 `trans` | 图表等的标题 `caption` |
| `cover_b` | `toc_b` | `cols-2-64` | `bq-purple` | 最后一页 `lastpage` | 非嵌套无序列表的毛玻璃效果 `fglass` |
| `cover_c` | | `cols-2-73` | `bq-red` | 导航栏 `navbar` | 脚注:`footnote` |
| `cover_d` | | `cols-3` | `bq-blue` | 标题固定+无底色 `fixedtitleA` | 调节字体大小:`tinytext`/`smalltext`/<br>`largetext`/`hugetext` |
| `cover_e` | | `cols-2-46` | `bq-green` | 标题固定+有底色 `fixedtitleB` | |
| | | `cols-2-37` | | 两列有序列表 `cols2_ol_sq/ci` | |
| | | `rows-2` | | 两列无序列表 `cols_ul_sq/ci` | |
| | | `pin-3` | | 单列有序列表 `col1_ul_sq/ci` | |
## 1. 关于模板
- Awesome Marp 的主题色(6 种),可在 YAML 区切换 Theme,如 `theme: am_dark`:
| 深色 | 绿色 | 红色 | 蓝色 | 棕色 | 紫色
|---------|----------|--------|---------|----------|----|
| `am_dark` | `am_green` | `am_red` | `am_blue` | `am_brown` |`am_purple`|
## 1. 关于模板
- 如何使用:
- **搭配 VS Code**:直接使用 VS Code 打开 `Awesome-Marp` 文件夹
- 如果你想「拿来即用」,直接根据我分享的 Markdown 源码文件,对照修改就好了~
- 如果你对部分效果不满意、期望简单微调的话,目前在 `Awesome-Marp/themes` 下有 6 个 CSS 文件,这些 CSS 文件决定了 Markdown 源码的最终渲染效果,可以试着改一改~
- 如果你能够自行定制个性化 CSS 文件,渲染前,别忘在 `Awesome-Marp/.vscode/settings.json` 里加上你的 CSS 文件路径~
- **搭配 Obsidian**:安装 [Marp Slides 插件](https://github.com/samuele-cozzi/obsidian-marp-slides),并配置相应 CSS 路径
- 字体:因担心版权问题,需自行下载字体并安装,Awesome Marp 用到的字体有:
- 正文字体:`Latin Modern Math`、`方正宋刻本秀楷简体`,如果未安装,默认将使用 `Calibri` 和 `楷体`
- 标题字体:`Optima LT Medium`、`方正苏新诗柳楷简体`,如果未安装,默认将使用 `Arial` 和 `黑体`
- 脚注字体:`Charm` 和 `叶根友毛笔行书修正版`,如果未安装,默认将使用 `Calibri` 和 `楷体`
- 代码字体:`Fira Code` 和 `霞鹜文楷等宽`,如果未安装,默认将使用 `Consolas` 和 `华文中宋`
## 1. 关于模板:更新日志
- [Awesome Marp v1.0:我开发了一整套 Marp 主题,Markdown 转换的 PPT 也可以很好看!](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486787&idx=1&sn=2652ddae81f50240844cb652780912e1&chksm=c13ff94bf648705da1ba986b91265e3ff018acaffcfa60d7807a81be22176005e7a2b4483627&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.1:标题行不随正文浮动,这下更像 Beamer 了!](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486800&idx=1&sn=527348e242576079e4bd6cd1823c823a&chksm=c13ff958f648704e40a202db6ad5fa215ef4c189d66403e161d6ace9828406a8747ac755684f&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.2:增加脚注、调节字体大小等样式~](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486825&idx=1&sn=56d632ce164831438ec87c1b20ed4c4c&chksm=c13ff961f64870774f069ab816340783d8f54fd6b89363b8d9412c593efc640851ce9edd8833&scene=178&cur_album_id=3132459596339757070#rd)
- [Awesome Marp v1.3:几处小更新~](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486869&idx=1&sn=fcc377ff6a5930436e5078a09d53f0ab&chksm=c13ff99df648708b89bafba030b27909d0022279e26da723ca54a1666fe55f50a4230f050662&scene=178&cur_album_id=3132459596339757070#rd)
## 下面让我们看看效果吧 ~
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 2. 封面页
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 2. 封面页
- 大标题:采用一级标题 `# ` (如:`# Awesome Marp:自定义 Marp 主题`)
- 副标题:采用六级标题 `###### ` (如:`###### 打造简便又不失个性的演示文稿`)
- 本套模板提供 5 种封面页样式,使用时需要在页面中设定局部指令,如:`<!-- _class: cover_a -->`
- `cover_a`:[第 1 种](#1)
- `cover_b`:[第 2 种](#12)
- `cover_c`:预留 header 可设定学校 logo,footer 可设定校训 [第 3 种](#13)
- `cover_d`:只预留了 footer 设定校训 [第 4 种](#14)
- `cover_e`:预留 header 设定学校 logo,footer 设定学校 logo 和学校名称[第 5 种](#15)
- 如果已经设定了全局 footer、header 或页码,但又不期望在封面页中出现,可以 `<!-- _footer: "" -->` / `<!-- _header: "" -->` / `<!-- _paginate: "" -->` 分别将其局部隐藏起来
- 当标题文字超过页面宽度会溢出换行,这里可以使用 `<!-- fit -->` 根据页面宽度自动调整文字大小
---
<!-- _class: cover_b -->
<!-- _header: "" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
# Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_c -->
<!-- _paginate: "" -->
<!-- _footer: 厚德博学 经济匡时 -->
<!-- _header: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291116463.png) -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_d -->
<!-- _paginate: "" -->
<!-- _footer: "厚德博学 经济匡时" -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
---
<!-- _class: cover_e -->
<!-- _paginate: "" -->
<!-- _footer: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291116463.png) -->
<!-- _header: ![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291053273.png) -->
# <!-- fit -->Awesome Marp:轻松取代 LaTeX Beamer!
###### “用法简单、功能全面的个性化 PPT 模板”
@初虹
公众号:虹鹄山庄
发布时间:2024 年 1 月 13 日(v1.3)
<ch2099058972@163.com>
Awesome-Marp 地址:[GitHub 库](https://github.com/favourhong/Awesome-Marp)/[Gitee 库](https://gitee.com/favourhong/Awesome-Marp)
## 3. 目录页
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 3. 目录页
- Awesome Marp 提供了至少 2 种目录页样式,使用时同样需要设定局部样式
- `toc_a`:需要将 header 的内容设定为 `CONTENTS`,即 `<!-- _header: "CONTENTS" -->`
- `toc_b`:需要将 header 的内容设定为 `目录<br>CONTENTS<br>你的LOGO地址`,即 `<!-- _header: 目录<br>CONTENTS<br>![](./logo.png)-->`
- 提供的几种分栏列表样式,也可以作为目录页使用,如 `<!-- _class: cols2_ol_ci fglass -->`(效果见[这里](#32))
- 类似地,如果已经定义了全局 footer 或页码,可以使用 `<!-- _footer: "" -->` / `<!-- _paginate: "" -->` 分别将其局部隐藏起来
- 目录页样式:[第 1 种](#2)、[第 2 种](#18)和[第 3 种](#19)
---
<!-- _class: toc_a -->
<!-- _header: "CONTENTS" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
---
<!-- _header: 目录<br>CONTENTS<br>![](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202405291053273.png)-->
<!-- _class: toc_b -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
- [关于模板](#3)
- [封面页](#10)
- [目录页](#16)
- [页面分栏与列表分列](#20)
- [引用、链接和引用盒子](#38)
- [导航栏](#45)
- [其他自定义样式](#48)
- [需要知道的基础知识](#56)
- [最后一页](#59)
## 4. 页面分栏与列表分列
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 4.1 页面分栏与列表分列:页面分栏
- Awesome Marp 提供了 8 种页面分栏方式,分别为:
- `cols-2`:[两列分栏,五五平分](#23)
- `cols-2-64`:[两列分栏,六四分](#24)
- `cols-2-73`:[两列分栏,七三分](#25)
- `cols-2-46`:[两列分栏,四六分](#26)
- `cols-2-37`:[两列分栏,三七分](#27)
- `cols-3`:[三列分栏,平分](#28)
- `rows-2`:[两行分栏](#29)
- `pin-3`:[品字型分栏](#30)
- 如果某一栏为图片,可以将 `class=ldiv` 换成 `class=limg`,这样能够实现图片的垂直居中对齐呢(`class=ldiv` 为居上对齐)
## 4.1 页面分栏与列表分列:页面分栏
- 以 `<!-- _class: cols-2 -->` 为例,Markdown 的源码为:
```markdown
<!-- _class: cols-2 -->
<div class=ldiv>
第一列(左侧栏)的内容在这里
内容可以是普通纯文本,可以是列表,也可以是引用块、链接、图片等
</div>
<div class=rdiv>
第二列(右侧栏)的内容在这里
</div>
```
- 如果是分三栏(`<!-- _class: cols-3 -->`),还需要再增加 `<div class="mdiv"></div>` 标签
## 《荷塘月色》(两栏五五分)
<!-- _class: cols-2 -->
<div class=ldiv>
曲曲折折的荷塘上面,弥望的是田田的叶子。叶子出水很高,像亭亭的舞女的裙。
层层的叶子中间,零星地点缀着些白花,有袅娜地开着的,有羞涩地打着朵儿的;正如一粒粒的明珠,又如碧天里的星星,又如刚出浴的美人。
微风过处,送来缕缕清香,仿佛远处高楼上渺茫的歌声似的。这时候叶子与花也有一丝的颤动,像闪电般,霎时传过荷塘的那边去了。
叶子本是肩并肩密密地挨着,这便宛然有了一道凝碧的波痕。叶子底下是脉脉的流水,遮住了,不能见一些颜色;而叶子却更见风致了。
—— 朱自清《荷塘月色》 [返回](#21)
</div>
<div class=rimg>
<!-- ![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221014499.png) -->
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221630151.png)
</div>
## 《春》(两栏六四分)
<!-- _class: cols-2-64 -->
<div class=limg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201217248.png)
</div>
<div class=rdiv>
盼望着,盼望着,东风来了,春天的脚步近了。
一切都像刚睡醒的样子,欣欣然张开了眼。山朗润起来了,水涨起来了,太阳的脸红起来了。
小草偷偷地从土里钻出来,嫩嫩的,绿绿的。园子里,田野里,瞧去,一大片一大片满是的。坐着,躺着,打两个滚,踢几脚球,赛几趟跑,捉几回迷藏。风轻悄悄的,草软绵绵的。
—— 朱自清《春》
[返回](#21)
</div>
## 经典散文诗篇(两栏七三分)
<!-- _class: cols-2-73 -->
<div class=limg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221010523.png)
</div>
<div class=rdiv>
经典的散文诗篇有:
- 朱自清:《荷塘月色》
- 林清玄:《月到天心》
- 郁达夫:《古都的秋》
- 张爱玲:《花落的声音》
- 余光中:《听听那冷雨》
- 张抗抗:《牡丹的拒绝》
- 丰子恺:《杨柳》
- 周作人:《乌篷船》
- 郑振铎:《石湖》
- 梁实秋:《雅舍》
[返回](#21)
</div>
## 《春》(两栏四六分)
<!-- _class: cols-2-46 -->
<div class=ldiv>
盼望着,盼望着,东风来了,春天的脚步近了。
一切都像刚睡醒的样子,欣欣然张开了眼。山朗润起来了,水涨起来了,太阳的脸红起来了。
小草偷偷地从土里钻出来,嫩嫩的,绿绿的。园子里,田野里,瞧去,一大片一大片满是的。坐着,躺着,打两个滚,踢几脚球,赛几趟跑,捉几回迷藏。风轻悄悄的,草软绵绵的。
—— 朱自清《春》
[返回](#21)
</div>
<div class=rimg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201217248.png)
</div>
## 经典散文诗篇(两栏三七分)
<!-- _class: cols-2-37 -->
<div class=ldiv>
经典的散文诗篇有:
- 朱自清:《荷塘月色》
- 林清玄:《月到天心》
- 郁达夫:《古都的秋》
- 张爱玲:《花落的声音》
- 余光中:《听听那冷雨》
- 张抗抗:《牡丹的拒绝》
- 丰子恺:《杨柳》
- 周作人:《乌篷船》
- 郑振铎:《石湖》
- 梁实秋:《雅舍》
[返回](#21)
</div>
<div class=rimg>
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309221010523.png)
</div>
## 夏与秋(三栏三平分)
<!-- _class: cols-3 -->
<div class=ldiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201206630.png)
</div>
<div class=mdiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201151809.png)
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201158036.png)
</div>
<div class=rdiv>
![#center](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309201154535.png)
[返回](#21)
</div>
## 高山与沙漠(两行分栏)
<!-- _class: rows-2 -->
<div class="timg">
![#c h:250](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131736186.png)
</div>
<div class="bimg">
![#c h:260](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131737821.png)
</div>
## 《宇宙的奥秘》(品字型分栏)
<!-- _class: pin-3 -->
<div class="tdiv">
> 四百年前,两位截然不同的科学家突破了当时已知世界的边界。1609 年在威尼斯,伽利略・伽利雷透过望远镜观察星辰,并制作仪器和进行实验。在布拉格,科班出身的神学家约翰内斯・开普勒发现了行星运动定律,奠定了近代天体物理学的基础,并思考着宇宙的宏伟构造。托马斯・德・帕多瓦以至今较少受到关注却扣人心弦的通信往来为基础,讲述了这两位类型如此迥异的学者之间不对等的关系,以及他们如何在同样的时刻却以各自的方式探索星辰的奥秘。在彼此的鉴照下,他们的远见与固执、睿智与无知得以呈现。这是一部介绍新科学的崛起以及近代来临之际的巨大变革的作品。 ——《宇宙的奥妙》
</div>
<div class="limg">
![#c](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131712626.png)
</div>
<div class="rimg">
![#c h:260](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131713779.png)
</div>
## 4.2 页面分栏与列表分列:列表分列
Awesome Marp v1.3 提供了 6 种列表分列的方式,分别为:
- `cols2_ol_sq`:呈现效果为[有序列表 + 方形序号](#32)
- `cols2_ol_ci`:呈现效果为[有序列表 + 圆形序号](#33)
- `cols2_ul_sq`:呈现效果为[无序列表 + 方形序号](#34)
- `cols2_ul_ci`:呈现效果为[无序列表 + 圆形序号](#35)
- `col1_ul_sq`:呈现效果为[有序列表 + 方形序号](#36)
- `col1_ul_ci`:呈现效应为[有序列表 + 圆形序号](#37)
## 《微观经济学:现代观点》
<!-- _class: cols2_ol_sq fglass -->
渲染效果为**有序列表+方形序号**
自定义样式为:`<!-- _class: cols2_ol_sq fglass -->`
- 偏好和效用
- 预算约束和消费者的最优选择
- 需求函数
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 博弈论
- 交换经济与生产经济
- 外部性与公共品
- 不确定性、期望效用和不对称信息
[返回](#28)
## 《微观经济学:现代观点》
<!-- _class: cols2_ol_ci fglass -->
渲染效果为**有序列表+圆形序号**
自定义样式为:`<!-- _class: cols2_ol_ci fglass -->`
- 偏好和效用
- 预算约束和消费者的最优选择
- 需求函数
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 博弈论
- 交换经济与生产经济
- 外部性与公共品
- 不确定性、期望效用和不对称信息
[返回](#28)
## 《置身事内》
<!-- _class: cols2_ul_sq fglass -->
渲染效果为**无序列表+方形序号**
自定义样式为:`<!-- _class: cols2_ul_sq fglass -->`
- 第一章:地方政府的权力与事务
- 第二章:财税与政府行为
- 第三章:政府投融资与债务
- 第四章:工业化中的政府角色
- 第五章:城市化与不平衡
- 第六章:债务与风险
- 第七章:国内国际失衡
- 第八章:政府与经济发展
[返回](#28)
## 《置身事内》
<!-- _class: cols2_ul_ci fglass -->
渲染效果为**无序列表+圆形序号**
自定义样式为:`<!-- _class: cols2_ul_ci fglass -->`
- 第一章:地方政府的权力与事务
- 第二章:财税与政府行为
- 第三章:政府投融资与债务
- 第四章:工业化中的政府角色
- 第五章:城市化与不平衡
- 第六章:债务与风险
- 第七章:国内国际失衡
- 第八章:政府与经济发展
[返回](#28)
## 《微观经济学:现代观点》
<!-- _class: col1_ol_sq fglass -->
渲染效果为**单列+有序列表+方形序号**
自定义样式为:`<!-- _class: col1_ul_sq fglass -->`
- 预算约束和消费者的最优选择
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 交换经济与生产经济
- 不确定性、期望效用和不对称信息
## 《微观经济学:现代观点》
<!-- _class: col1_ol_ci fglass -->
渲染效果为**单列+有序列表+圆形序号**
自定义样式为:`<!-- _class: col1_ul_ci fglass -->`
- 预算约束和消费者的最优选择
- 劳动力和储蓄的供给函数
- 福利经济学:单人模型和多人模型
- 企业理论:单投入品和多投入品模型
- 完全竞争市场
- 完全垄断、垄断竞争与双寡头垄断
- 交换经济与生产经济
- 不确定性、期望效用和不对称信息
## 5. 引用、链接和 Callouts
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 5. 引用、链接和 Callouts
- 引用的呈现效果为:
> 合成控制法 (Synthetic Control Method) 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。
- 链接的呈现效果:
- [经管数据清洗与 Stata 实战:三大地级市数据库和 CSMAR 上市公司数据](https://mp.weixin.qq.com/s/D0cYVPJJsNiu61GcYwV6cg)
- [Stata 基础:从论文文件夹体系的建立说起](https://mp.weixin.qq.com/s?__biz=MzkwOTE3NDExOQ==&mid=2247486489&idx=1&sn=2eb51e85a01541c7a552a9434e087512&scene=21#wechat_redirect)
- Callouts 是 Awesome Marp 提供的自定义的样式,有 5 种颜色可选:
- [紫色](#40):`bq-purple`
- [蓝色](#41):`bq-blue`
- [绿色](#42):`bq-green`
- [红色](#43):`bq-red`
- [黑色](#44):`bq-black`
## 5. 引用、链接和引用盒子
<!-- _class: bq-purple -->
- 自定义样式为:`<!-- _class: bq-purple -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-blue -->
- 自定义样式为:`<!-- _class: bq-blue -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-green -->
- 自定义样式为:`<!-- _class: bq-green -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-red -->
- 自定义样式为:`<!-- _class: bq-red -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 5. 引用、链接和引用盒子
<!-- _class: bq-black -->
- 自定义样式为:`<!-- _class: bq-black -->`
> 合成控制法 (Synthetic Control Method)
>
> SCM 最早由 Abadie and Gardeazabal (2003) 提出,用来研究西班牙巴斯克地区恐怖活动的经济成本,属于案例研究范畴 (Case Study)。Athey & Imbens (2017) 认为它是过去 15 年计量方法领域最重要的创新。<br>
> 合成控制法的基本思想是:虽然无法找到巴斯克地区的最佳控制地区,但可对西班牙的若干大城市进行适当的线性组合(赋予不同的权重),以构造一个更为贴切的「合成控制地区」 (Synthetic Control Region),然后将真实的巴斯克地区与「合成的巴斯克地区」进行对比,即可得到恐袭的影响。
[返回](#39)
## 6. 导航栏
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 6. 导航栏
<!-- _class: navbar -->
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* **导航栏** *基础知识*-->
- 一句题外话:打造 Awesome Marp 模板的最早初衷就是来自几位公众号粉丝朋友的询问,「Marp 是否也能实现想 Beamer 那样的顶部导航栏?」为了实现导航栏的效果,我又多学了一些 CSS 的知识,这套模板才得以成型
- 自定义样式为 `navbar`:`<!-- _class: navbar -->`
- 导航栏修改自 header,最前面必须加入 `\ `
- 当前活动标题,使用粗体 `**粗体**`
- 其余非活动标题,使用斜体 `*斜体*`
- 如果左侧有文字,需要使用斜粗体 `***粗斜体***`
- 默认根据内容自动分配间距,如果希望右对齐,可以手动增加空格的方式来推动右对齐
## 6. 导航栏
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* **导航栏** *基础知识*-->
<!-- _class: navbar -->
这张页面的部分 Markdown 源码:
```markdown
<!-- _class: navbar -->
<!-- _header: \ ***虹鹄山庄***
- 自定义样式为 `navbar`:`<!-- _class: navbar -->`
- 导航栏修改自 header,最前面必须加入 `\ `
- 当前活动标题:使用粗体 `**粗体**`
- 其余非活动标题:使用斜体 `*斜体*`
- 如果左侧有文字:使用斜粗体 `***粗斜体***`
- 默认根据内容自动分配间距,如果希望右对齐,可以手动增加空格的方式来推动右对齐
```
## 7. 其他自定义样式
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## 7.1 固定标题行:更像 Beamer 了(`fixedtitleA`)
<!-- _class: fixedtitleA -->
- 自定义样式:`<!-- _class: fixedtitleA -->`
- 使当前页面的标题栏固定在顶部,而非随着内容的多少浮动
- 同时,页面内容也会从顶部起笔,而非垂直方向上居中显示
## 7.1 固定标题行:更像 Beamer 了(`fixedtitleB`)
<!-- _class: fixedtitleB -->
<div class="div">
- 自定义样式:`<!-- _class: fixedtitleB -->`
- `fixedtitleB` 相比于 `fixedtitleA`,标题增加了底色色块,同时缩小了标题大小
- 其余效果与 `fixedtitleA` 相同
- 但是页面正文内容需要包裹在 `<div class="div'></div>` 标签中
</div>
---
<!-- _class: footnote -->
<div class="tdiv">
#### 7.2 脚注的自定义样式:`footnote`
使用方法:
- 自定义样式:`<!-- _class: footnote -->`
- 页面除脚注外的其他内容,写在 `<div class = "tdiv"></div>`
- 页面的脚注内容,写在 `<div class = "bdiv"></div>`
举个例子,展示一下显示效果:
- 一方面,经济金融化程度的加深,使得金融部门能够凭借资本跨期配置提前抽取其他部门的未来价值,从而扩大金融和非金融部门之间的外部收入差距$^1$。另一方面,经济金融化不断增加企业股东权力,促使企业更加追求股东价值最大化,这一导向将弱化普通劳动者阶层的议价能力,食利者阶层的财产性收入增加必然会挤压劳动收入份额,从而扩大了内部收入差距$^2$。
</div>
<div class="bdiv">
1 张甜迪. 金融化对中国金融、非金融行业收入差距的影响[J]. 经济问题, 2015(11): 40-46.
2 Hein E. Finance-dominated capitalism and re-distribution of income: a Kaleckian perspective[J]. Cambridge Journal of Economics, 2015, 39(3): 907-934.
</div>
## 7.3 调节文字大小的自定义样式
<!-- _class: largetext -->
对于字体大小的调节,直接修改 CSS 文件应该很方便的。但有小伙伴提出,“希望可以增加字体调节的自定义样式”,于是目前提供了四种微调样式:
- 自定义样式 1:`<!-- _class: tinytext -->` (是默认字体大小的 0.8 倍)
- 自定义样式 2:`<!-- _class: smalltext -->` (是默认字体大小的 0.9 倍)
- 自定义样式 3:`<!-- _class: largetext -->` (是默认字体大小的 1.15 倍)
- 自定义样式 4:`<!-- _class: hugetext -->` (是默认字体大小的 1.3 倍)
比如,本页面采用的自定义样式为 `largetext`
## 7.4 图表标题的自定义样式:`caption`
<!-- _class: caption -->
- 通过 `<div class="caption">宇宙的奥妙</div>` 来定义图表的标题
![#c h:380](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202401131712626.png)
<div class="caption">
宇宙的奥妙
</div>
## 需要知道的基础知识……
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
## Markdown 概览
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar -->
- Markdown 是一种**极轻量**的文本标记语言,允许人们使用**易读易写**的纯文本格式编写文档,而且对于表格、代码、图片、公式等支持良好
- 应用广泛:网站、课程笔记/讲义、演示文稿、撰写学术论文等
- Markdown 基础语法:
- 参阅:[Markdown 中文文档](https://markdown-zh.readthedocs.io/en/latest/)、[Markdown 指南](https://www.markdown.xyz/)、[Markdown 菜鸟教程](https://www.runoob.com/markdown/md-tutorial.html)
- 标题 `#`、粗体 `** **`、斜体 `* *`、删除线 `~~ ~~`、分割线 `---`、超链接 `[]()`
- 引用 `>`、列表 `-` / `1. `、代码块
- 脚注 `[^1]` / `[^1]:`、待办事项 `[ ]` / `[x]`
- Markdown 进阶语法:
- 图片 `![]()`:本地路径、网络路径(参阅:[图床与 PicGo——让你爱上记录与分享](https://sspai.com/post/65716))
- 数学公式:行内公式 `$...$`、行间公式 `$$...$$`
- 支持 HTML 元素:`<br>`/`<hr>`/`<b></b>`/`<i></i>`/`<kbd></kbd>` 等
## 推荐的 Markdown 编辑器
<!-- _class: cols-2-64 navbar -->
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<div class=ldiv>
**VS Code**
- Visual Studio Code[下载地址](https://code.visualstudio.com/Download)
- VS Code 插件:
- 配合 Markdown:[Markdown Preview Enhanced](https://marketplace.visualstudio.com/items?itemName=shd101wyy.markdown-preview-enhanced)、[Markdown All in One](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one)
- 图床:[PicGo](https://marketplace.visualstudio.com/items?itemName=Spades.vs-picgo)
- 格式化文档:[Pangu-Markdown](https://marketplace.visualstudio.com/items?itemName=xlthu.Pangu-Markdown)
- Markdown 转 PPT:[Marp for VScode](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode)
- Markdown 转思维导图:[Markmap for VScode](https://marketplace.visualstudio.com/items?itemName=gera2ld.markmap-vscode)
- 配合 Zotero:[Citation Picker for Zotero](https://marketplace.visualstudio.com/items?itemName=mblode.zotero)、[Pandoc Citer](https://marketplace.visualstudio.com/items?itemName=notZaki.pandocciter)
</div>
<div class=rdiv>
**Obsidian**
- [Obsidian 主页](https://obsidian.md/)
- 基于 Markdown 的本地知识管理软件
- 除官方同步和发布功能外,对个人使用者完全免费
- 功能丰富、插件众多、开发社区活跃
</div>
## Marp 基本用法
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar fixedtitleB -->
<div class="div">
- 几个字总结 [Marp](https://marp.app/):使用 Markdown 创作演示文稿
- 来自 Marp 官方网页的一段话:Marp (also known as the Markdown Presentation Ecosystem) provides an intuitive experience for creating beautiful slide decks. You only have to focus on writing your story in a Markdown document.
- 在 Markdown 文件的顶部 YAML 区域,通过 `marp: true` 启动 Marp,然后即可开启侧边预览,VS Code 界面左边是代码区域,右边为预览区域
- 内容遵循 Markdown 语法,但 Marp 增加了一些内置指令,而且指令分为全局指令和[局部指令](https://marpit.marp.app/directives?id=local-directives-1),全局指令建议放置于 YAML 区,局部指令位于当前页面,不同页面通过 `---` 切分
- 推荐阅读:Marpit [官方文档](https://marpit.marp.app)及[中译版](https://caizhiyuan.gitee.io/categories/skills/20200730-marp.html#%E5%8A%9F%E8%83%BD),五分钟学会 Marp[(上)](https://www.lianxh.cn/news/97fccdca2d7a5.html)、[(下)](https://www.lianxh.cn/news/521900220dd33.html)
</div>
## Marp 基本用法
<!-- _header: \ ***@Awesome Marp*** *关于模板* *封面页* *目录页* *分栏与分列* *引用盒子* *导航栏* **基础知识**-->
<!-- _class: navbar -->
```yaml
---
marp: true # 开启 Marp
size: 16:9 # 设定页面比例,常见有 16:9 或 4:3,默认为16:9
theme: gaia # 切换主题,内置 3 种样式的主题,可以自定义主题
paginate: true # 开启页码
headingDivider: 2 # 通过二级标题切分页面,省去手动换页的麻烦
footer: 初虹 # 设置页脚区域的内容,如果设定页眉的内容,则为 header
---
```
- 如果想让页面同时被多个级别的标题切分,比如,以二级~四级标题分割页面,可以 `headingDivider: [2,3,4]`
- 想要使得多个自定义样式渲染同一个页面,可直接将不同自定义样式以空格连接,比如:`<!-- _class: cols-2-64 fglass -->`
---
<!-- _class: lastpage -->
<!-- _footer: "" -->
###### 欢迎交流 ~
<div class="icons">
- <i class="fa-solid fa-envelope"></i>
- 邮箱:ch2099058972@163.com
- <i class="fa-brands fa-weixin"></i>
- 微信:favourhong
- <i class="fa-solid fa-house"></i>
- 公众号:虹鹄山庄
<div>
## 创作不易,buy me a coffee 🤙~
<!-- _class: trans -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
<br>
![#c w:300](https://mytuchuang-1303248785.cos.ap-beijing.myqcloud.com/picgo/202309240907419.png)
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
+168
View File
@@ -0,0 +1,168 @@
---
theme: border
size: 16:9
header: title of presentation
_header: ""
footer: footer
_footer: ""
paginate: true
_paginate: false
created: 2025-09-09T19:23
updated: 2025-09-22T13:27
---
<!-- _class: title -->
<!-- _class: lead -->
# Title
---
# Agenda
1. text
1. text
1. text
1. text
---
# Section
Text
---
# Introduction
Text
---
# Text
text
---
# Two Columns
## column 1
text
## column 2
text
---
# Two Columns with Picture
## column 1
text
![bg right](../attachments/placeholder-circle.png)
---
# Three Columns
## column 1
text
## column 2
text
## column 3
text
---
# Basic Block List
- text
- text
- text
- text
- text
---
# Picture
![center](../attachments/placeholder-circle.png)
---
# Table
| text | text | text | text |
|---|---|---|---|
| text | text | text | text |
| text | text | text | text |
| text | text | text | text |
---
# Quote
> Quote of the day
---
# Code
``` javascript
var foo = ""
```
---
# Long Code
``` javascript
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo = ""
var foo1 = ""
var foo1 = ""
var foo1 = ""
var foo1 = ""
```
---
# Math
Text text .....:
$$ I_{xx}=\int\int_Ry^2f(x,y)\cdot{}dydx $$
Text text .....:
$$
f(x) = \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi
$$
Conclusion
+84
View File
@@ -0,0 +1,84 @@
---
theme: academic
paginate: true
math: latex
created: 2025-09-08T22:43
updated: 2025-09-09T18:22
---
<!-- _class: lead -->
# Create lab presentation slides with Marp
#### ~Let's graduate from Beamer~
<br />
**Author Taro**
Hogehoge Laboratory M2
YYYY/MM/DD
---
<!-- _header: table of contents -->
1. First of all
1. Code block
1. Formula
1. Figure
---
<!-- _header: Introduction -->
- Marp is software for creating **slides** in **Markdown**.
- Basic Markdown syntax is supported.
- You can move to the next page just by putting `---` in Markdown. $^1$
> 1: Marp is developed according to the Markdown specification called CommonMark, so the "footnote" grammar (using `[^1]`), which is not included in CommonMark, is not provided. Therefore, by referring to https://github.com/marp-team/marp/discussions/150#discussioncomment-1302384, a pseudo-footnote was realized.
---
<!-- _header: code block -->
```python
import torch
print(torch.cuda.is_available())
```
You can write a code block like this.
```python
from transformers import AutoModelForMaskedLM, AutoTokenizer
model = AutoModelForMaskedLM.from_pretrained("cl-tohoku/bert-base-japanese-whole-word-masking")
tokenizer = AutoTokenizer.from_pretrained("cl-tohoku/bert-base-japanese-whole-word-masking")
inputs = tokenizer.encode_plus("I'm very [MASK]", return_tensors='pt')
outputs = model(**inputs)
tokenizer.convert_ids_to_tokens(outputs.logits[0][1:-1].argmax(axis=-1))
```
The width is automatically adjusted (see [Auto-scaling](https://github.com/marp-team/marp-core#auto-scaling-features) in the document).
---
<!-- _header: formula -->
$$I_{xx}=\int\int_Ry^2f(x,y)\cdot{}dydx$$
$$
f(x) = \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi
$$
You can write the formula like this. Of course you can also use inline $\LaTeX$.
You can also use emojis :smile:
---
<!-- _header: Figure -->
1. First, right-click to download the image (`kenkyu_woman_seikou.png`) from [This Irasutoya link](https://www.irasutoya.com/2018/10/blog-post_723.html).
2. Create a directory named `images` in this directory with Markdown, and place the image you downloaded earlier. You are now ready to go.
![w:300 center](../attachments/kenkyu_woman_seikou.png)
+56
View File
@@ -0,0 +1,56 @@
---
marp: true
theme: beamer
paginate: true
size: 16:9
header: This is a header
footer: This is a footer
title: Marp custom themes
created: 2025-09-09T18:22
updated: 2025-09-22T13:27
---
<!-- _class: title -->
# A very long title of my beamer presentation
<br/>
Author's name
University of XYZ
2022-26-03
(Only normal text is centered now)
---
# A normal slide
# H1 again
## H2
### H3
- bullet
> quote
```
code
```
text
---
# Title page ad hoc fix
If the title of your presentation is too long and the border intersects with the text underneath, use the following
```html
# Title
<br/>
<!-- empty line here --->
Author's name
University of XYZ
...
```
make sure to leave an empty line below the `<br/>` tag
---
<!-- _class: tinytext -->
# Tinytext class
- use `<!-- _class: tinytext -->` to make some text tiny
- might be useful for References
+48
View File
@@ -0,0 +1,48 @@
---
created: 2025-09-09T18:22
updated: 2025-09-22T13:27
---
<!-- _class: lead -->
# Title
---
<!-- _class: divider -->
# Agenda
- title 1
- title 2
- title 3
---
# Content
![bg right](../attachments/placeholder-circle.png)
## Content 1
### Content 2
Content 3
---
# Content 1
![bg right](../attachments/placeholder-circle.png)
## Content 1
### Content 2
Content 3
---
# Content 2
![bg right](../attachments/placeholder-circle.png)
## Content 1
### Content 2
Content 3
+24
View File
@@ -0,0 +1,24 @@
---
theme: gaia
paginate: true
backgroundColor: #fff
backgroundImage: url('https://marp.app/assets/hero-background.svg')
style: @import url('https://unpkg.com/tailwindcss@^2/dist/utilities.min.css')
---
<div class="grid grid-cols-2 gap-4">
<div>
## Column 1
Lorem ipsum dolor sit amet consectetur adipisicing elit. Voluptas eveniet, corporis commodi vitae accusamus obcaecati dolor corrupti eaque id numquam officia velit sapiente incidunt dolores provident laboriosam praesentium nobis culpa.
</div>
<div>
## Column 2
Tempore ad exercitationem necessitatibus nulla, optio distinctio illo non similique? Laborum dolor odio, ipsam incidunt corrupti quia nemo quo exercitationem adipisci quidem nesciunt deserunt repellendus inventore deleniti reprehenderit at earum.
</div>
</div>
+25
View File
@@ -0,0 +1,25 @@
---
theme: default
footer: Samuele Cozzi
created: 2025-09-09T18:22
updated: 2025-09-22T13:27
---
# First Slide
---
# Second Slide
## subtitle
![bg right 50%](../attachments/placeholder-circle.png)
---
# Third Slide
## second subtitle
![](../attachments/placeholder-circle.png)
+94
View File
@@ -0,0 +1,94 @@
---
theme: default
footer: Samuele Cozzi
created: 2025-09-09T18:22
updated: 2025-09-22T13:27
---
# <!-- fit --> First Slide
ciao
---
# Second Slide
## subtitle
![bg right 50%](../attachments/placeholder-circle.png)
---
# Third Slide
## second subtitle
![](../attachments/placeholder-circle.png)
---
# Autoscaling Code
```
bool getBit(int num, int i) {
return ((num & (1<<i)) != 0);
}
bool getBit(int num, int i) {
return ((num & (1<<i)) != 0) + ((num & (1<<i)) != 0) + ((num & (1<<i)) != 0) + ((num & (1<<i)) != 0) + ((num & (1<<i)) != 0);
}
bool getBit(int num, int i) {
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;int i = 0;
int i = 0;
int i = 0;int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;int i = 0;
int i = 0;
int i = 0;int i = 0;
return ((num & (1<<i)) != 0);
popo
}
```
---
# Autoscaling Math
$$
f(x) = \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi + \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi + \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi + \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi + \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi + \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi
$$
+100
View File
@@ -0,0 +1,100 @@
---
theme: minimal-container-turquoise
created: 2025-09-09T18:22
updated: 2025-09-22T13:27
---
<!-- _class: lead -->
# Title
## Subtitle
---
<!-- _class: box-flex -->
# Columns Containers
**[markdown-it-container](https://github.com/markdown-it/markdown-it-container)**
::: container
## Colum 1
text dadadas text text text text text text text text text text
:::
::: container
## Colum 2
text
:::
---
# Text Highlights
**[markdown-it-mark](https://github.com/markdown-it/markdown-it-mark)**
This is ==marked== text
---
![bg](../attachments/kroki_cheatsheet_20210515_v1.1_EN.jpeg)
---
# PlantUML Diagram
**[markdown-it-kroki](https://github.com/kazumatu981/markdown-it-kroki)**
```plantuml[platuml image]
@startuml
left to right direction
actor Guest as g
package Professional {
actor Chef as c
actor "Food Critic" as fc
}
package Restaurant {
usecase "Eat Food" as UC1
usecase "Pay for Food" as UC2
usecase "Drink" as UC3
usecase "Review" as UC4
}
fc --> UC4
g --> UC1
g --> UC2
g --> UC3
@enduml
```
---
# Mermaid Gant Diagram
**[markdown-it-kroki](https://github.com/kazumatu981/markdown-it-kroki)**
```mermaid
gantt
title A Gant Diagram
dateFormat YYYY-MM-DD
section Section
Initial milestone : milestone, m1, 2014-01-01,
Final milestone : milestone, m1, 2014-02-16,
A task :a1, 2014-01-01, 30d
Another task :after a1, 20d
section Another
Task in sec :2014-01-12, 12d
another task : 24d
```
---
# CallOuts (Work in Progress)
https://github.com/ebullient/markdown-it-obsidian-callouts
+353
View File
@@ -0,0 +1,353 @@
---
theme: minimal-turquoise
paginate: true
_paginate: false
header: Title of deck
_header:
footer: this is footer
_footer: ""
created: 2025-09-09T18:22
updated: 2025-09-22T13:27
---
<!-- _class: lead -->
# <!-- fit --> Title of Deck
## <!-- fit --> Subtitle Subtitle Subtitle Subtitle Subtitle
**Author**
Milan, Marp Demo
YYYY/MM/DD
---
<!-- _class: divider -->
## Agenda
1. text
1. text
1. text
1. text
---
<!-- _class: divider -->
### Introduction
text
![bg right:33%](../attachments/placeholder-circle.png)
---
<!-- _class: divider -->
### Introduction
text
![bg right:33%](https://t3.ftcdn.net/jpg/02/48/42/64/360_F_248426448_NVKLywWqArG2ADUxDq6QprtIzsF82dMF.jpg)
---
<!-- _class: divider -->
## Section Header
Section Details
---
## Content
### Subsection 1
#### Subsection 2
##### Subsection 3
###### Subsection 4
Text
---
## Two Columns Image
### column 1
text
![bg right](../attachments/placeholder-circle.png)
---
<!-- _class: 'box-flex' -->
## Two Columns
- ### column 1
text
- ### column 2
text
---
<!-- _class: 'box-flex center' -->
## Two Columns With Centered Pictures
- ### picture 1
![center h:400](../attachments/placeholder-circle.png)
- ![center](../attachments/placeholder-circle.png)
---
<!-- _class: 'box-flex box-bg' -->
## Three Columns
- ### column 1
text
- ### column 2
text
- ### column 3
text
---
<!-- _class: 'box-flex box-bg' -->
## Four Columns
- ### column 1
text
- ### column 2
text
- ### column 3
text
- ### column 4
lorem ipsum lorem ipsum lorem ipsum lorem ipsum lorem ipsum lorem ipsum
---
<!-- _class: 'box-flex box-bg' -->
## Six Columns
- ### column 1
text
- ### column 2
text
- ### column 3
text
- ### column 4
text
- ### column 5
text
- ### column 6
text
---
<!-- _class: 'box-flex box-bg' -->
## Eight Columns
- ### column 1
text
- ### column 2
text
- ### column 3
text
- ### column 4
text
- ### column 5
text
- ### column 6
text
- ### column 7
text
- ### column 8
text
---
<!-- _class: center -->
## Picture
![center](../attachments/placeholder-circle.png)
---
## Table
| text | text | text | text |
|---|---|---|---|
| text | text | text | text |
| text | text | text | text |
| text | text | text | text |
---
<!-- _class: divider-->
> Quote of the day
---
## Code
``` javascript
var foo = ""
```
---
<!-- _footer: '' -->
<!-- _paginate: false -->
## Autoscaling Code
```
bool getBit(int num, int i) {
return ((num & (1<<i)) != 0);
}
bool getBit(int num, int i) {
return ((num & (1<<i)) != 0) + ((num & (1<<i)) != 0) + ((num & (1<<i)) != 0) + ((num & (1<<i)) != 0) + ((num & (1<<i)) != 0);
}
bool getBit(int num, int i) {
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;int i = 0;
int i = 0;
int i = 0;int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;
int i = 0;int i = 0;
int i = 0;
int i = 0;int i = 0;
return ((num & (1<<i)) != 0);
popo
}
```
---
## Math
Text text .....:
$$ I_{xx}=\int\int_Ry^2f(x,y)\cdot{}dydx $$
Text text .....:
$$
f(x) = \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi
$$
Conclusion
---
## Autoscaling Math
$$
f(x) = \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi + \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi + \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi + \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi + \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi + \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi
$$
---
<!-- _class: divider -->
<!-- _footer: '' -->
<!-- _paginate: false -->
![bg left:33%](../attachments/placeholder-circle.png)
### Summary
This is the summary of presentation
---
<!-- _class: divider -->
## Thank You
Author
mail@email.com
www.author.com
@Twitter
+15
View File
@@ -0,0 +1,15 @@
---
theme: minimal-turquoise
created: 2025-09-09T18:22
updated: 2025-09-22T13:27
---
<!-- _class: lead -->
# Title
---
![](attachments/placeholder-circle.png)
---
![bg](attachments/placeholder-circle.png)
+98
View File
@@ -0,0 +1,98 @@
/* @theme academic */
@import 'gaia';
@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+JP:wght@400;700&display=swap');
@import url('https://fonts.googleapis.com/css2?family=Source+Code+Pro&display=swap');
:root {
--color-background: #fff;
--color-foreground: #333;
--color-highlight: #800000;
}
section {
background-image: none;
font-family: 'Noto Sans JP', sans-serif;
padding-top: 90px;
padding-left: 40px;
padding-right: 40px;
}
/* https://github.com/marp-team/marpit/issues/271 */
section::after {
font-weight: 700;
content: attr(data-marpit-pagination) '/' attr(data-marpit-pagination-total);
}
ul ul {
font-size: 0.9em;
}
section.lead h1 {
color: #800000;
text-align: left;
}
section.lead h1 strong {
-webkit-text-stroke: 1px #800000;
}
section.lead h2 {
color: #800000;
text-align: left;
}
section.lead h2 strong {
-webkit-text-stroke: 1px #800000;
}
section.lead h3 {
color: #800000;
text-align: left;
}
section.lead h3 strong {
-webkit-text-stroke: 1px #800000;
}
section.lead h4 {
color: #800000;
text-align: left;
}
section.lead h4 strong {
-webkit-text-stroke: 1px #800000;
}
section.lead h5 {
color: #800000;
text-align: left;
}
section.lead h5 strong {
-webkit-text-stroke: 1px #800000;
}
section.lead p {
text-align: right;
}
header {
background-color: #800000;
color: #fff;
font-size: 1em;
font-weight: 700;
}
blockquote {
max-width: 90%;
border-top: 0.1em dashed #555;
font-size: 60%;
position: absolute;
bottom: 20px;
}
blockquote::before {
content: "";
}
blockquote::after {
content: "";
}
img[alt~="center"] {
display: block;
margin: 0 auto;
}
code {
font-family: 'Source Code Pro', monospace;
}

Some files were not shown because too many files have changed in this diff Show More