> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eurekanews.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Your First Article

> Learn how to create and format your first article

## Creating a New Article

### Navigate to Articles

1. Go to `/admin/articles` in the admin dashboard
2. Click the **"New Article"** button

## Fill Out the Article Form

### Required Fields

#### Title

* Your article headline
* Should be clear and engaging
* Example: "How to Use DeFi Protocols on Abstract Chain"

#### Slug

* Auto-generated from your title
* Used in the article URL
* Can be edited if needed
* Example: `how-to-use-defi-protocols-on-abstract-chain`

#### Excerpt

* A short summary (1-2 sentences)
* Appears in article previews and social media shares
* Should entice readers to click
* Example: "Learn how to interact with DeFi protocols on Abstract Chain, from connecting your wallet to making your first swap."

#### Content

* Your full article content
* Supports **Markdown formatting**
* Can include images, links, code blocks, and more
* See [Content Formatting](#content-formatting) below

#### Author

* Automatically set to you
* Cannot be changed (writers can only publish under their own name)

#### Tags (Required)

* Select 2-6 relevant tags
* You can only select tags you've been assigned
* See [Tag System](/writers/tags) for more details

### Optional Fields

#### Featured Image

* Click "Choose from Media Library" to select an image
* Or upload a new image
* Recommended size: 1200x630px for best social media display
* Required if you want your article featured on the homepage

#### SEO Title (Optional)

* Custom title for search engines (defaults to your article title)
* Keep it under 60 characters

#### SEO Description (Optional)

* Custom description for search engines (defaults to your excerpt)
* Keep it under 160 characters

#### Content Type

* Choose: `news`, `guide`, or `analysis`
* **News**: Time-sensitive updates and announcements
* **Guide/Analysis**: More evergreen content that remains relevant over time
* Affects URL structure
* Example: `/news/article-slug` vs `/guides/article-slug`

#### Read Time

* Estimated reading time in minutes
* Auto-calculated based on word count
* Can be manually adjusted

#### Podcast Embed URL

* If your article has an accompanying podcast episode
* Paste the PodBean embed URL

## Content Formatting

Eureka News uses **Markdown** for article content. Here's a quick reference:

### Basic Formatting

```markdown theme={null}
**Bold text**
*Italic text*
***Bold and italic***

# Heading 1
## Heading 2
### Heading 3

- Bullet point
- Another bullet

1. Numbered list
2. Second item

[Link text](https://example.com)
```

### Code Blocks

```markdown theme={null}
Inline `code` with backticks
```

For code blocks with syntax highlighting:

```javascript theme={null}
// Code block with syntax highlighting
function example() {
  return "Hello, World!";
}
```

### Images

```markdown theme={null}
![Alt text](/images/filename.png)
```

Or use the media library to insert images directly. Images should be placed in the media library and referenced with descriptive alt text.

### Blockquotes

```markdown theme={null}
> This is a quote
> Can span multiple lines
```

### Embedding Content

#### Embedding Tweets

To embed a tweet, use the following format:

```markdown theme={null}
Big news from @AbstractChain:

![Tweet](https://twitter.com/AbstractChain/status/1234567890)

This changes everything for DeFi on Abstract!
```

**Format:** `![Tweet](url to x post)`

<Tip>
  The editor will automatically format Twitter/X links if you paste them as plain URLs. You can either use the formatted syntax above or simply paste the URL on its own line.
</Tip>

**Best practices:**

* Add context before the tweet to explain why it's relevant
* Add commentary after the embed to provide additional insights
* Use tweet embeds to cite official announcements and sources

#### Embedding YouTube Videos

To embed a YouTube video, use the following format:

```markdown theme={null}
Here's a tutorial on using Abstract Chain:

![YouTube](https://www.youtube.com/watch?v=VIDEO_ID)

This video covers the basics of DeFi on Abstract.
```

**Format:** `![YouTube](https://www.youtube.com/watch?v=VIDEO_ID)`

<Tip>
  The editor will automatically format YouTube links if you paste them as plain URLs. You can either use the formatted syntax above or simply paste the URL on its own line.
</Tip>

**Supported YouTube URL formats:**

* `https://www.youtube.com/watch?v=VIDEO_ID`
* `https://youtu.be/VIDEO_ID`
* `https://www.youtube.com/embed/VIDEO_ID`

#### Creating URL Links

To create a clickable link, use standard Markdown link syntax:

```markdown theme={null}
[Link text](https://example.com)
```

**Examples:**

```markdown theme={null}
Visit the [Abstract Chain website](https://abs.xyz) for more information.

Check out this [DeFi protocol](https://example.com/defi) for yield farming.

For documentation, see the [official guide](https://docs.example.com).
```

**Best practices:**

* Use descriptive link text that explains where the link goes
* Link to official sources and verified information
* Use links to cite sources and provide additional context
* Avoid generic link text like "click here" or "read more"

#### Smart Tag Mentions

You can easily link to projects, tokens, and topics directly within your article content using **Smart Tag Mentions**:

1. Type `@` followed by the tag name (e.g., `@bitcoin`)
2. Select the correct tag from the autocomplete dropdown
3. The mention will appear as a handle (e.g., `@bitcoin`)

**What readers see:** On the live site, these mentions automatically transform into interactive Smart Chips that display the project/tag name, logo, live market data (for crypto assets), and a direct link to the tag's page.

**Example:**

```markdown theme={null}
The recent developments in @bitcoin have sparked renewed interest in the crypto market. Meanwhile, @abstract-chain continues to innovate with new DeFi protocols.
```

For more details, see the [Tag System documentation](/writers/tags#smart-tag-mentions).

## Saving Your Article

### Save as Draft

* Saves your work without submitting
* You can continue editing later
* Article is not visible to editors or the public
* Use this while you're still writing

### Submit for Review

* Submits your article to the editorial team
* Editors will review and provide feedback
* You'll be notified when the review is complete

<Tip>
  **Need to make changes after submitting?** If you need to edit your article after submitting it for review, simply click "Save Draft" and the article will automatically return to draft status. Make your edits, then click "Submit for Review" again when ready.
</Tip>

<Note>
  Before submitting, make sure:

  * All required fields are filled
  * Content is complete and proofread
  * Tags are selected and relevant
  * Featured image is uploaded (if desired)
</Note>