IkiWik...1title(3pm)

✨ NAME ✨

ikiwiki Plug-in: h1title 💖

(also known as IkiWik...1title(3pm), filed under User Contributed Perl Documentation, so you already know it's a community gem 🫶)

---

🌸 SYNOPSIS 🌸

okay so bestie, here's the whole vibe: if the very first line of your page is a level 1 Markdown atx-style header — you know, the hash mark kind — this plugin grabs it, uses it to set the page title, and then yeets it out of the page body so it doesn't get rendered twice. no dupes, no drama. 💅

and the level 1 headers that show up anywhere else on the page? those get ignored. completely. they're not the main character here. 👑

so for example, this page right here will end up with the title My Title, and the rendered page body will start off with the level two header Introduction.:

# My Title

## Introduction

Introductory text with a list:

 * Item 1
 * Item 2

## Second header

Second section

and the tea on why you'd want this ☕ — it plays super nice with page templates that use <h1> tags for the page title. so you get a consistent header hierarchy in your rendered pages, while keeping the Markdown source clean and free of meta directives. it's giving best of both worlds, fr fr. 🦋

---

💜 AUTHOR 💜

Jason Blevins <jrblevin@sdf.lonestar.org>, — yes the comma is part of it, we respect the punctuation here 🎀

---

🌈 SEE ALSO 🌈

• ikiwiki Homepage: http://ikiwiki.info/
• ikiwiki Plugin Documentation: http://ikiwiki.info/plugins/write/

go read them, iykyk 📚✨

---

👑 LICENSE 👑

Copyright (C) 2008 Jason Blevins

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

no cap, read the license fr — it's short, it's iconic, and it's literally the whole legal vibe of this thing 🫡

---

and that's the whole page, bestie!! this one shipped with perl v5.40.1 and got its lil timestamp on 2026-02-03 💖✨ bye ily, go make some beautiful headers 🎀🦋