Editing the

Parent (hide)

Title

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<link href="/webjars/wiki%3Axwiki/xwiki-platform-search-webjar/17.1.0/searchSuggest.min.css?evaluate=true" type='text/css' rel='stylesheet'/>
<link href="/webjars/wiki%3Axwiki/font-awesome/4.7.0/css/font-awesome.min.css" rel='stylesheet'/>
<link href="/webjars/wiki%3Axwiki/webjar-blueimp-gallery/3.4.0/css/blueimp-gallery.min.css" type='text/css' rel='stylesheet'/>
<link href="/webjars/wiki%3Axwiki/xwiki-platform-image-lightbox-webjar/17.1.0/less/lightbox.less?evaluate=true" type='text/css' rel='stylesheet'/>
<link href="/webjars/wiki%3Axwiki/xwiki-platform-tree-webjar/17.1.0/tree.min.css?evaluate=true" type='text/css' rel='stylesheet'/>
<link href="/webjars/wiki%3Axwiki/xwiki-platform-ckeditor-plugins/17.1.0/webjar.bundle.min.css?evaluate=true" type='text/css' rel='stylesheet'/>
<link href="/webjars/wiki%3Axwiki/xwiki-platform-tree-webjar/17.1.0/finder.min.css?evaluate=true" type='text/css' rel='stylesheet'/>

</head>
<body id="body" class="skin-flamingo viewbody main wiki-xwiki
space-Guides_and_Help.the_basics"><h1 id="HD83DDCDAMarkdownWritingGuideforTheWhiteArchiveWiki" class="wikigeneratedid"><span>📚 <strong>Markdown Writing Guide for The White Archive Wiki</strong></span></h1><p>Welcome to the Markdown Writing Guide for <strong>The White Archive Wiki</strong>! This guide will help you write clean, well-organized pages in Markdown, making it easy for users to read and navigate content.</p><h2 id="HEditorsnote:I27mnotthisintofirearmsIswear2CIthinktheAIwasjustuncomfortablesayingpoliticallyincorrectthings.Socalmitdownglowies." class="wikigeneratedid"><span><em>Editors note: I'm not this into firearms I swear, I think the AI was just uncomfortable saying politically incorrect things. So calm it down glowies.</em></span></h2><hr/><h2 id="H2705QuickMarkdownReference" class="wikigeneratedid"><span>✅ <strong>Quick Markdown Reference</strong></span></h2><table><tr><th scope="col"><strong>Feature</strong></th><th scope="col"><strong>Markdown Syntax</strong></th></tr><tr><td>Header 1</td><td><span class="box"><span class="code"># Header 1</span></span></td></tr><tr><td>Bullet List</td><td><span class="box"><span class="code">- Item</span></span></td></tr><tr><td>Numbered List</td><td><span class="box"><span class="code">1. Item</span></span></td></tr><tr><td>Internal Link</td><td><span class="box"><span class="code">[/path/to/page]</span></span></td></tr><tr><td>External Link</td><td><span class="box"><span class="code">[Text](URL)</span></span></td></tr><tr><td>Image</td><td><span class="box"><span class="code">![Alt Text](path/to/image)</span></span></td></tr><tr><td>Blockquote</td><td><span class="box"><span class="code">&gt; Quote</span></span></td></tr><tr><td>Table</td><td><span class="box"><span class="code">| Column | Column |</span></span></td></tr><tr><td>Code Block</td><td>```bash</td></tr><tr><td>Task List</td><td><span class="box"><span class="code">- [ ] Task</span></span></td></tr><tr><td>Bold</td><td><span class="box"><span class="code">**Bold**</span></span></td></tr><tr><td>Italic</td><td><span class="box"><span class="code">_Italic_</span></span></td></tr></table><hr/><h2 id="HD83DDD8BFE0FMarkdownBasicsforWikiPages" class="wikigeneratedid"><span>🖋️ <strong>Markdown Basics for Wiki Pages</strong></span></h2><p>Markdown is a lightweight language used to convert plain text into structured HTML. It’s simple to learn and helps ensure consistency across all Wiki pages.</p><hr/><h2 id="HD83DDD241.Headers28TitlesandSubtitles29" class="wikigeneratedid"><span>🔤 <strong>1. Headers (Titles and Subtitles)</strong></span></h2><p>Headers are used to organize content into sections and subsections. The more <span class="box"><span class="code">#</span></span> symbols you use, the smaller the header.</p><table><tr><th scope="col">Markdown Syntax</th><th scope="col">Rendered Output</th></tr><tr><td><span class="box"><span class="code"># Title (Header 1)</span></span></td><td>🟢 <strong>Title (Header 1)</strong></td></tr><tr><td><span class="box"><span class="code">## Subtitle (Header 2)</span></span></td><td>🟢 <strong>Subtitle (Header 2)</strong></td></tr><tr><td><span class="box"><span class="code">### Section (Header 3)</span></span></td><td>🟢 <strong>Section (Header 3)</strong></td></tr></table><p><strong>Example:</strong></p><!--startmacro:code|-|language="markdown"|-|# The History of Firearms

## Early Developments

### Innovations in the 20th Century--><div class="box"><div class="code"># The History of Firearms<br/><br/>## Early Developments<br/><br/>### Innovations in the 20th Century</div></div><hr/><h2 id="HD83DDCCB2.Lists28BulletPointsandNumberedLists29" class="wikigeneratedid"><span>📋 <strong>2. Lists (Bullet Points and Numbered Lists)</strong></span></h2><p>Use lists to organize ideas or break down content into digestible points.</p><h3 id="HD83DDD39BulletPoints" class="wikigeneratedid"><span>🔹 <strong>Bullet Points</strong></span></h3><p>Use <span class="box"><span class="code">-</span></span> or <span class="box"><span class="code">*</span></span> to create bullet points.</p><div class="box"><div class="code">- First Bullet Point<br/>- Second Bullet Point<br/>&nbsp;&nbsp;- Sub-bullet Point</div></div><p><strong>Output:</strong></p><ul><li>First Bullet Point</li><li>Second Bullet Point<ul><li>Sub-bullet Point</li></ul></li></ul><hr/><h3 id="HD83DDD22NumberedLists" class="wikigeneratedid"><span>🔢 <strong>Numbered Lists</strong></span></h3><p>To create ordered lists, simply use numbers followed by a period.</p><div class="box"><div class="code">1. First item<br/>2. Second item<br/>&nbsp;&nbsp;&nbsp;1. Sub-item</div></div><p><strong>Output:</strong></p><ol><li>First item</li><li>Second item<ol><li>Sub-item</li></ol></li></ol><hr/><h2 id="HD83DDD173.Links28InternalandExternal29" class="wikigeneratedid"><span>🔗 <strong>3. Links (Internal and External)</strong></span></h2><p>Use the following format to link to other pages within the wiki. Make sure to include the / at the start of the page path.</p><div class="box"><div class="code">[Page Title](/path-to-page) &nbsp;&nbsp;[Black Crime](/black-crime)</div></div><p><span class="wikiexternallink"><a href="/black-crime">Black Crime</a></span></p><p>Note in the example above a couple things. If the text you wrap in brackets matches a page name it will automatically fill out the rest once you put in the: <span class="box"><span class="code">(/</span></span></p><p>The page title wrapped in brackets can be anything you want, it doesn't have to match the page name or path. For Example:</p><div class="box"><div class="code">[this Can Say anything](/black-crime)</div></div><p>Will still output a link to the page black crime, but the link itself will display what you wrap in brackets.</p><p><span class="wikiexternallink"><a href="/black-crime">this can say anything</a></span></p><p>The path IS case sensitive, and must begin with / for you to use only the page directory. If you dont put the / you would have to include a full link.</p><div class="box"><div class="code">[full link example](https://thewhitearchive.org/en/black-crime)</div></div><p>Outputs <span class="wikiexternallink"><a href="https://thewhitearchive.org/en/black-crime">full link example</a></span></p><hr/><h2 id="HD83CDF10ExternalLinks28Websites29" class="wikigeneratedid"><span>🌐 <strong>External Links (Websites)</strong></span></h2><p>For external links, use the standard Markdown format:</p><div class="box"><div class="code">[Text](https://example.com)</div></div><hr/><h2 id="HD83DDDBC4.Images" class="wikigeneratedid"><span>🖼 <strong>4. Images</strong></span></h2><h3 id="HEmbeddingImages" class="wikigeneratedid"><span>Embedding Images</span></h3><p>Embed images in your pages using markdown</p><div class="box"><div class="code">&nbsp;&nbsp;&nbsp;![categories.jpg](/categories.jpg) <br/></div></div><p><img src="/categories.jpg" alt="categories"/></p><p>For clickable images that open larger versions in a new page:</p><p><span class="box"><span class="code">&lt;a href="/imagename.jpg"&gt;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;img src="/imagenamethumb.jpg" alt="Image 1"&gt;<br/>&lt;/a&gt;</span></span></p><p>renders as</p><a href="/categories.jpg">
    <img src="/categoriesthumb.jpg" alt="Image 1">
</a><p>when you replace the imagename with the uploaded file name. Note for this to work you must upload 2 images, one for the thumbnail one for the bigger image.</p><p>This way is easier to remember but you can do either in markdown. <span class="box"><span class="code">&nbsp;[![categories](https://www.thewhitearchive.org/categoriesthumb.jpg)](https://www.thewhitearchive.org/categories.jpg))</span></span></p><p>This renders as</p><p><span class="wikicreatelink"><a href="/bin/create/categoriesthumb.jpg/WebHome%5D%5D/WebHome?parent=Guides+and+Help.the_basics.WebHome">![[categories</a></span></p><p>If you're having trouble with it showing up, the important part is the <span class="box"><span class="code">![ex](fulllink)]</span></span> then just put the larger image next to it <span class="box"><span class="code">(fulllinkagain)</span></span></p><p>To ensure images meet quality and usability standards, test resizing and clarity before uploading. Suggested tools include:</p><ul><li><span class="wikiexternallink"><a href="https://www.reduceimages.com/">ReduceImages</a></span> for single-image resizing.</li><li><span class="wikiexternallink"><a href="https://imagemagick.org/">image magick</a></span> for batch images. I've even put together <span class="wikiexternallink"><a href="/admin/scripts">scripts</a></span> that you can save which will take all the images from one folder, resize and rename them, and output them in 2 separate folders</li></ul><p>For <strong>Wiki.js</strong>, upload images to the <strong>Assets Manager</strong> and use their paths directly.</p><hr/><h2 id="HD83DDCAC5.Blockquotes" class="wikigeneratedid"><span>💬 <strong>5. Blockquotes</strong></span></h2><p>Blockquotes are used to highlight important information, quotes, or warnings.</p><div class="box"><div class="code">&gt; This is a note or warning.</div></div><p><strong>Output:</strong></p><blockquote><p>This is a note or warning.</p></blockquote><hr/><h2 id="HD83DDCCA6.Tables" class="wikigeneratedid"><span>📊 <strong>6. Tables</strong></span></h2><p>Tables are helpful for organizing facts, events, or comparisons.</p><div class="box"><div class="code">| **Year** | **Event** &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;| **Country** |<br/>|---------|--------------------|-------------|<br/>| 1791 &nbsp;&nbsp;&nbsp;| Second Amendment &nbsp;&nbsp;&nbsp;| USA &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<br/>| 1836 &nbsp;&nbsp;&nbsp;| Colt Revolver Invented | USA &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<br/>| 1947 &nbsp;&nbsp;&nbsp;| AK-47 Introduced &nbsp;&nbsp;&nbsp;| USSR &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|</div></div><p><strong>Output:</strong></p><table><tr><th scope="col"><strong>Year</strong></th><th scope="col"><strong>Event</strong></th><th scope="col"><strong>Country</strong></th></tr><tr><td>1791</td><td>Second Amendment</td><td>USA</td></tr><tr><td>1836</td><td>Colt Revolver Invented</td><td>USA</td></tr><tr><td>1947</td><td>AK-47 Introduced</td><td>USSR</td></tr></table><hr/><h2 id="HD83EDDF17.CodeBlocks" class="wikigeneratedid"><span>🧱 <strong>7. Code Blocks</strong></span></h2><p>Code blocks are useful for commands, scripts, or technical information.</p><h3 id="HInlineCode:" class="wikigeneratedid"><span><strong>Inline Code:</strong></span></h3><p>Use backticks <span class="box"><span class="code">&nbsp;</span></span> ` for inline code.</p><div class="box"><div class="code">The command `ls -la` lists all files in a directory.</div></div><p><strong>Output:</strong><br/>The command <span class="box"><span class="code">ls -la</span></span> lists all files in a directory.</p><h3 id="HCodeBlocks:" class="wikigeneratedid"><span><strong>Code Blocks:</strong></span></h3><p>Use triple backticks (```) to create a code block.</p><p><span class="box"><span class="code">&nbsp;docker ps -a</span></span></p><p>See the page on <span class="wikiexternallink"><a href="/admin/coding">coding</a></span></p><hr/><h2 id="HD83DDCCB9.TaskLists" class="wikigeneratedid"><span>📋 <strong>9. Task Lists</strong></span></h2><p>Task lists help track progress on tasks or projects.</p><div class="box"><div class="code">- [ ] Research historical firearm development<br/>- [x] Add images to the timeline<br/>- [ ] Link related Wiki pages</div></div><p><strong>Output:</strong></p><ul><li>[ ] Research historical firearm development</li><li>[x] Add images to the timeline</li><li>[ ] Link related Wiki pages</li></ul><hr/><h2 id="HD83CDFA810.FormattingText28Bold2CItalic2CHighlight29" class="wikigeneratedid"><span>🎨 <strong>10. Formatting Text (Bold, Italic, Highlight)</strong></span></h2><table><tr><th scope="col">Syntax</th><th scope="col">Output</th></tr><tr><td><span class="box"><span class="code">**Bold**</span></span></td><td><strong>Bold</strong></td></tr><tr><td><span class="box"><span class="code">_Italic_</span></span></td><td><em>Italic</em></td></tr><tr><td><span class="box"><span class="code">==Highlight==</span></span></td><td>==Highlight==</td></tr><tr><td><span class="box"><span class="code">~~Strikethrough~~</span></span></td><td><del>Strikethrough</del></td></tr></table><hr/><h2 id="HD83EDDE911.EmbeddingNotes28ForInternalLinks29" class="wikigeneratedid"><span>🧩 <strong>11. Embedding Notes (For Internal Links)</strong></span></h2><p>To embed the content of another Wiki page, use:</p><div class="box"><div class="code">![Page Content](page-content)</div></div><hr/><h2 id="HD83EDDEAExamplePageStructure" class="wikigeneratedid"><span>🧪 <strong>Example Page Structure</strong></span></h2><p>Here's an example of a complete page using the elements we've covered:</p><!--startmacro:code|-|language="markdown"|-|# The History of Firearms

## Overview
The development of firearms has shaped human history. This page covers key events and innovations.

## Early Developments
The earliest firearms date back to the 9th century.

### Innovations in the 20th Century
- 1903: First semi-automatic pistol.
- 1947: Introduction of the AK-47.

## Notable Firearms
| **Name**    | **Year Introduced** | **Country** |
|-\-\-\-\-\-\-\-\-\-\-\-\-|-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-|-\-\-\-\-\-\-\-\-\-\-\-\-|
| Colt Revolver | 1836               | USA         |
| AK-47        | 1947               | USSR        |--><div class="box"><div class="code"># The History of Firearms<br/><br/>## Overview<br/>The development of firearms has shaped human history. This page covers key events and innovations.<br/><br/>## Early Developments<br/>The earliest firearms date back to the 9th century.<br/><br/>### Innovations in the 20th Century<br/>- 1903: First semi-automatic pistol.<br/>- 1947: Introduction of the AK-47.<br/><br/>## Notable Firearms<br/>| **Name** &nbsp;&nbsp;&nbsp;| **Year Introduced** | **Country** |<br/>|-------------|---------------------|-------------|<br/>| Colt Revolver | 1836 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;| USA &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<br/>| AK-47 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;| 1947 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;| USSR &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|</div></div><hr/><h2 id="HRelatedPages" class="wikigeneratedid"><span>Related Pages</span></h2><ul><li><span class="wikiexternallink"><a href="/admin/coding">coding</a></span></li><li><span class="wikicreatelink"><a href="/bin/create/en/admin/contribute/formatting-advanced?parent=Guides+and+Help.the_basics.WebHome">advanced formatting</a></span></li></ul><hr/><h3 id="HD83CDFAFNextStepsforContributors:" class="wikigeneratedid"><span>🎯 <strong>Next Steps for Contributors:</strong></span></h3><ol><li>Start writing your pages using this guide.</li><li>Link related pages for better navigation.</li><li>Use images and tables to enhance your content.</li><li>Tag your pages for better searchability.</li></ol><p>This guide will ensure your pages are consistently formatted and easy to read.</p></body>
</html>

Minor edit

Editing title and content of the_basics

Page Information