القائمة
Include source code from an external file (whole file, line range, or named region) with auto-detected highlighting. Use to embed real code from the repo without copy-pasting and risking drift.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Author the YAML frontmatter block of a Neko Markdown page — label, icon, order, tags, visibility, permalink, redirect, redirectSlug, layout, meta, nav, toc, backlinks, password. Use when configuring an individual page.
Author the project-level `neko.yml` — input/output paths, URL, branding, theme, meta tags, top navigation, banner, footer, snippets. Use when configuring or editing a Neko site at the project level.
Render a Mermaid diagram (flowchart, sequence, class, ER, state, gantt, journey, mindmap, sankey, XY, architecture) from a fenced ```mermaid``` block. Use for any structured diagram in docs.
Workflow for updating Neko documentation — base every page on the real source code, never invent APIs, warn loudly when the source isn't available, and check that the page (and any changed `tesserae` sample) renders correctly with Playwright / snapframe / a visual check. Use whenever you add or edit docs that describe code, APIs, components, or live samples.
Render a live Tesserae C# UI block — Neko compiles and executes the C# at build time and shows both the code and a working preview side-by-side. Use only when the project documents Tesserae or runs live C# samples.
Render C# API docs from a code block with XML doc comments (`/// <summary>`, `<param>`, `<returns>`, etc.). Use to embed API reference inline without a separate generator.
| name | code-snippet |
| description | Include source code from an external file (whole file, line range, or named region) with auto-detected highlighting. Use to embed real code from the repo without copy-pasting and risking drift. |
Includes the contents of a file at build time, with syntax highlighting based on the file extension. Useful for keeping documentation in sync with real code.
:::code source="../static/sample.js" :::
:::code source="../src/Program.cs" language="csharp" :::
:::code source="../src/Util.cs" range="1-10" :::
:::code source="../src/Util.cs" region="MyRegion" :::
:::code source="../src/Util.cs" title="Util.cs" :::
| Attribute | Notes |
|---|---|
source | Required. Path to the file (relative to the current .md). |
language | Override auto-detection (e.g. language="csharp"). |
range | Line range, inclusive, 1-indexed. range="1-20". |
region | C# #region NAME / #endregion block to extract. |
title | Optional title shown in the snippet header. |
:::code source="../samples/basic-page.md" title="Minimum page" :::
:::code source="../src/Calculator.cs" region="Add" language="csharp" :::
:::code source="../scripts/build.sh" range="1-15" language="bash" :::
code-snippet when the source lives elsewhere and you want it to stay
fresh as the file changes.code-block for short illustrative
examples that have no source-of-truth file.