V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
woolensheep
V2EX  ›  分享创造

md2report-一个用于将 Markdown 文件转换为可以直接提交给学校的实验报告的工具

  •  2
     
  •   woolensheep ·
    woolen-sheep · 2022-11-09 13:25:56 +08:00 · 1879 次点击
    这是一个创建于 753 天前的主题,其中的信息可能已经有所发展或是发生改变。

    大学三年写了包含实验报告和各种结课报告、小论文在内的无数报告。很多课程要求必须提交 word 格式的报告,但是我认为 word/docx 真的很难用,即使使用设置好的模板也经常遇到样式效果和预期不符的情况。而且很多课程老师给出的模板本身就是一团糟,没有定义样式,正文改一改字体和字号就发出来了。

    所以希望能有一个一键式的由 markdown 生成实验报告的工具。

    现在已经有能将 markdown 转换为 docx 的工具,比如 pandoc 。但是转换产物的样式离实验报告有很大差距,即使使用--reference-doc 依然不能达到直接提交的要求。于是就写了 md2report 这个工具。

    md2report 大体上是一个 pandoc filter ,对 pandoc 生成的 Json AST 做了一些修改,使之符合大学报告的要求。对于有些无法在 AST 中实现的修改,则使用 python-docx 修改最后生成的 docx 文件。

    目前支持一键生成华中科技大学的实验报告,如果任何学校的学生认为这个工具有意义,可以发 PR 添加你们学校的模板。

    ** 欢迎 Star / PR **

    Github

    文档

    WebUI

    效果图

    abstract_zh

    abstract

    TOC

    Headings

    Tables

    Images

    Code block

    2 条回复    2022-11-10 18:41:54 +08:00
    4ark
        1
    4ark  
       2022-11-09 16:47:05 +08:00
    感谢,支持一下
    SomeBottle
        2
    SomeBottle  
       2022-11-10 18:41:54 +08:00
    写实验报告的时候 word 用起来确实有点难受😂
    mark 一下
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2705 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 25ms · UTC 09:06 · PVG 17:06 · LAX 01:06 · JFK 04:06
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.