scientific-skills/markdown-mermaid-writing/templates/research_paper.md
Back to Markdown Style Guide โ Read the style guide first for formatting, citation, and emoji rules.
Use this template for: Research papers, technical analyses, literature reviews, data-driven reports, competitive analyses, market research, or any document built around evidence and methodology. Designed for heavy citation, structured argumentation, and reproducible findings.
Key features: Abstract for quick assessment, methodology section for credibility, findings with supporting data/diagrams, rigorous footnote citations throughout, and a complete references section.
Philosophy: A great research document lets the reader evaluate your conclusions independently. Show your work. Cite your sources. Present counter-arguments. The reader should trust your findings because the evidence is right there โ not because you said so.
[bracketed placeholders] with your content[^N] footnote1. Abstract โ What you did, what you found, why it matters (150-300 words)
2. ๐ Introduction โ Problem statement, context, scope, research questions
3. ๐ Background โ Prior work, literature review, industry context
4. ๐ฌ Methodology โ How you did the research, data sources, approach
5. ๐ Findings โ What you discovered, with evidence and diagrams
6. ๐ก Analysis โ What the findings mean, implications, limitations
7. ๐ฏ Conclusions โ Summary, recommendations, future work
8. ๐ References โ All cited sources with full URLs
Everything below the line is the template. Copy from here:
[Author(s) or Team] ยท [Organization] ยท [Date]
[150โ300 word summary structured as: Context (1โ2 sentences on the problem space), Objective (what this paper investigates), Method (how the research was conducted), Key findings (the most important results), Significance (why this matters and who should care).]
Keywords: [keyword 1], [keyword 2], [keyword 3], [keyword 4], [keyword 5]
[What problem exists? Why does it matter? Who is affected? Be specific โ include metrics where available.]
[The scope of the problem, with citation]1.
This paper investigates:
[Current state of the field. What's known. What the established approaches are. Cite existing work.]
[Key finding from prior research]2. [Another relevant study found]3.
| Study / Source | Key Finding | Relevance to Our Work |
|---|---|---|
| [Author (Year)]4 | [What they found] | [How it connects] |
| [Author (Year)]5 | [What they found] | [How it connects] |
| [Author (Year)]6 | [What they found] | [How it connects] |
[What's missing from existing research? What question remains unanswered? This is the gap your paper fills.]
<details> <summary><strong>๐ Extended Literature Review</strong></summary>[Deeper discussion of related work, historical context, evolution of approaches, and detailed comparison of methodologies used by prior researchers. This depth supports the paper's credibility without cluttering the main flow.]
</details>[Describe your research methodology โ qualitative, quantitative, mixed methods, experimental, observational, case study, etc.]
flowchart LR
accTitle: Research Methodology Flow
accDescr: Four-phase research process from data collection through analysis to validation and reporting
collect[๐ฅ Data **collection**] --> clean[โ๏ธ Data **cleaning**]
clean --> analyze[๐ **Analysis**]
analyze --> validate[๐งช **Validation**]
validate --> report[๐ค Report **findings**]
classDef process fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#1e3a5f
class collect,clean,analyze,validate,report process
| Source | Type | Size / Scope | Collection Period |
|---|---|---|---|
| [Source 1] | [Survey / API / Database / etc.] | [N records / respondents] | [Date range] |
| [Source 2] | [Type] | [Size] | [Date range] |
<details> <summary><strong>๐ง Detailed Methodology</strong></summary>โ ๏ธ Known limitations: [Be upfront about what could affect the validity of your results โ sample size, selection bias, time constraints, data quality issues. This builds credibility, not weakness.]
[Step-by-step description of how data was gathered]
[What transformations were applied, what was excluded and why]
[Specific tests, confidence levels, software used]
[How someone else could replicate this research โ data availability, code repositories, environment setup]
</details>[Present the finding clearly. Lead with the conclusion, then show the evidence.]
[Data supporting this finding]7:
| Metric | Before | After | Change |
|---|---|---|---|
| [Metric 1] | [Value] | [Value] | [+/- %] |
| [Metric 2] | [Value] | [Value] | [+/- %] |
๐ Key insight: [One-sentence takeaway from this finding]
[Present the finding. Include a diagram if the finding involves relationships, processes, or comparisons.]
xychart-beta
title "[Chart title]"
x-axis ["Category A", "Category B", "Category C", "Category D"]
y-axis "Measurement" 0 --> 100
bar [45, 72, 63, 89]
[Explanation of what the data shows and why it matters.]
[Present the finding with supporting evidence.]
<details> <summary><strong>๐ Supporting Data Tables</strong></summary>[Detailed data tables, raw numbers, statistical breakdowns that support the findings but would interrupt the reading flow if placed inline. Readers who want to verify can expand.]
</details>[What do the findings mean? Connect back to your research questions. Explain the "so what?"]
For [audience 1]:
For [audience 2]:
[How do your findings compare with the studies referenced in the Background section? Do they confirm, contradict, or extend prior work?]
[What caveats should the reader keep in mind? What factors might affect generalizability? Be honest โ this is where credibility is built.]
<details> <summary><strong>๐ฌ Discussion Notes</strong></summary>[3โ5 sentences. Restate the problem, summarize the key findings, and state the primary recommendation. A reader who skips to this section should understand the entire paper's value.]
All sources cited in this paper:
Last updated: [Date]
[Author/Org]. ([Year]). "[Title]." [Publication]. https://example.com โฉ
[Author/Org]. ([Year]). "[Title]." [Publication]. https://example.com โฉ
[Author/Org]. ([Year]). "[Title]." [Publication]. https://example.com โฉ
[Author/Org]. ([Year]). "[Title]." [Publication]. https://example.com โฉ
[Author/Org]. ([Year]). "[Title]." [Publication]. https://example.com โฉ
[Author/Org]. ([Year]). "[Title]." [Publication]. https://example.com โฉ
[Author/Org]. ([Year]). "[Title]." [Publication]. https://example.com โฉ